home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / misc / genbox20.arj / GENBOX.HLP < prev    next >
Text File  |  1994-02-21  |  115KB  |  2,367 lines

  1.  
  2. TOP                             GENBOX (tm)
  3.                             Shareware Version 2.0 
  4.                       Copyright 1994 Thoughtful Creations
  5.     
  6.       ┌─────────────────────────────────────────────────────────────────┐
  7.       │      ***** SHAREWARE VERSION - FREELY REDISTRIBUTABLE *****     │
  8.       └─────────────────────────────────────────────────────────────────┘
  9.       
  10.       Press ENTER for instructions on using <ONLINE HELP>. Or, use the ARROW
  11.       KEYS to highlight one of the marked keywords below, then press ENTER:
  12.       
  13.       <CHAPTER 1: INTRODUCTION>               An introduction to GENBOX.
  14.       <CHAPTER 2: GETTING STARTED>            How to get started.
  15.       <CHAPTER 3: MAIN MENU>                  The main menu help.
  16.       <CHAPTER 4: OPTIONS>                    Controlling GENBOX operation.
  17.       <CHAPTER 5: VIEWING/EDITING CHART>      Looking at the chart onscreen.
  18.       <CHAPTER 6: TIPS AND TECHNIQUES>        For the advanced user.
  19.       <CHAPTER 7: FEDIT>                      Font editor utility.
  20.       <APPENDIX A: READING THE CHARTS>        Help on reading the charts.
  21.       <APPENDIX B: GLOSSARY>                  Definitions of terms.
  22.       <APPENDIX C: RELEASE NOTES>             Summary of version updates.
  23.     
  24. _______________________________________________________________________________
  25. ###############################################################################
  26.     
  27. CHAPTER 1: INTRODUCTION
  28.     
  29.     GENBOX produces presentation-quality genealogy box charts from GEDCOM
  30.     files. You will need to have a genealogy database program that supports the
  31.     GEDCOM output format (such as Brother's Keeper or Personal Ancestral File)
  32.     in order to enter your own genealogy data. After you have done this, use
  33.     your database program to produce a GEDCOM file. Then, this GEDCOM file
  34.     can be used by GENBOX to produce box charts of your genealogy data.
  35.     
  36.     Help Sections available in CHAPTER 1:
  37.     
  38.     <FEATURES>                 An overview of key features.
  39.     <REGISTERING>              Ordering information for registered version.
  40.     <SHAREWARE VERSION>        Shareware/registered version differences.
  41.     <LIMITED WARRANTY>         Warranty for registered version.
  42.     <COPYRIGHT AND TRADEMARKS> Copyright information; product support
  43. _______________________________________________________________________________
  44.     
  45.     
  46. FEATURES
  47.     
  48.     GENBOX produces presentation-quality genealogy box charts, up to 255
  49.     generations:
  50.     
  51.     * 5 CHART TYPES: Descendant, Ancestor, Related, Everyone, Custom Box Charts
  52.     * ADVANCED GEDCOM DATA SUPPORT: tag inclusion, priorities, order, labels
  53.     * SCREEN PREVIEWER: preview/edit charts with full scrolling; print & save
  54.     * PROFESSIONAL INTERFACE: menus; context-sensitive help; many options
  55.     * ADVANCED PRINTING: landscape printing for continuous chart "strips"
  56.     
  57.     It has a number of space-saving features, designed to minimize the wasted
  58.     space commonly found on genealogy charts produced by other programs:
  59.     
  60.     * DYNAMIC BOX WIDTHS. The width of each box on the chart can vary,
  61.       depending on the amount of data available for the persons named in the
  62.       box. Each box is made just wide enough, so wasted space inside each box
  63.       is at a minimum. With other chart programs that support only a fixed box
  64.       width, the boxes either are all small, meaning some information can not
  65.       be displayed, or they are all large, making the chart very wide.
  66.       
  67.     * UNIQUE "TUCK-UNDER" ALGORITHM. Descendant box charts typically have few
  68.       boxes at the top, and widen in each successive generation. Thus, the
  69.       lower generations have the most boxes, and determine the width of the
  70.       chart. Children boxes are centered below the box of their parents. But
  71.       not all persons have children; thus, there is often empty space on either
  72.       the left or right side of a family of children boxes. By allowing
  73.       families with multiple children to "tuck under" the boxes of individuals
  74.       in the parent's generation who do NOT have children represented on the
  75.       chart, it is possible to reduce the overall width of the chart. This
  76.       technique is extended to the placement of all boxes. In general: children
  77.       boxes, as a group, are centered beneath their parent's box; then, this
  78.       structure is moved left until another box in either the children's
  79.       generation or the parent's generation is reached. This is then repeated
  80.       for successively higher generations, moving larger structures.
  81.     
  82.     * PRIORITIZED SUBFIELD INCLUSION. Most chart programs have a fixed set of
  83.       data items that are included in each box. GENBOX allows you to prioritize
  84.       the inclusion of data items, so that when there is more data than will
  85.       fit in the selected box minimum-maximum sizes, the lower-priority data
  86.       will be left out. An example where this is useful is with NOTE data.
  87.       NOTES can be short, or very lengthy. A good compromise on NOTES is to
  88.       include the shorter notes in the boxes, and leave out the longer notes;
  89.       and in either case, give higher priority to birth, death, and marriage
  90.       data.
  91.     
  92.     
  93. REGISTERING
  94.     
  95.     This product is distributed as SHAREWARE. Shareware distribution gives you
  96.     a chance to TRY software before BUYING it. You may copy and distribute the
  97.     <SHAREWARE VERSION> of GENBOX to whomever you wish, provided that it is not
  98.     altered in any way or included as part of another system. Whoever continues
  99.     using the shareware version after a reasonable trial period is expected to
  100.     REGISTER.
  101.     
  102.     If you decide that GENBOX is useful to you, and have not registered, send a
  103.     U.S. bank check or money order for $45.00* to:
  104.        
  105.                          Thoughtful Creations
  106.                          ATTN: William T. Flight
  107.                          GENBOX Registration
  108.                          P.O. Box 19406
  109.                          Cincinnati, OH  45219
  110.                         
  111.     *OHIO RESIDENTS: please add 5.5% sales tax (for a total of $47.48).
  112.          
  113.     COMPUSERVE USERS: You may register online! Type "GO SWREG". Choose "Search
  114.     by Title", and enter "genbox". The fee will be charged to your account.
  115.  
  116.     YOU WILL RECEIVE: a 3-1/2" diskette (or specify 5-1/4") containing the
  117.     latest registered version of GENBOX with the advanced features, the FEDIT
  118.     font editor utility, additional fonts and GEDCOM files, and a printed
  119.     manual. The registration fee licenses ONE COPY for use on any one computer
  120.     at any one time. 
  121.     
  122.  
  123. SHAREWARE VERSION RESTRICTIONS
  124.     
  125.     The shareware version contains all of the functionality of the registered
  126.     version, EXCEPT for the advanced GEDCOM support options. These advanced
  127.     options allow you to choose what data is included in the boxes, how it is
  128.     ordered, how it is labeled, and how it is prioritized. With the REGISTERED
  129.     VERSION, you can include notes, occupations, titles, addresses, emigration
  130.     and other special events, miscellaneous data, and user-defined tags. Any
  131.     and all information stored for individuals and families in your GEDCOM file
  132.     can be selected for inclusion on the charts, and ordered and labeled just
  133.     the way you want!
  134.     
  135.     The shareware version does NOT restrict the sizes of the charts produced or
  136.     GEDCOM files processed. Instead, the box contents are restricted. In
  137.     particular: the settings on the TAGS options window can not be changed
  138.     from their default values in the shareware version. The default TAGS
  139.     settings provide for the following basic data types in each box:
  140.     
  141.     * Person Name                    * Spouse Name
  142.     * Birth-baptism date/place       * Spouse birth-baptism date/place
  143.     * Death-burial date/place        * Spouse death-burial date/place
  144.     * Marriage date/place
  145.     
  146.     In addition, the charts printed in landscape mode are stamped with "GENBOX
  147.     EVALUATION COPY" as a reminder that the shareware version is intended for
  148.     evaluation purposes only.
  149.     
  150.     The registered version of GENBOX contains FEDIT.EXE, a utility for creating
  151.     and modifying fonts for use with GENBOX. It also contains additional
  152.     fonts and GEDCOM files.
  153.     
  154.  
  155. LIMITED WARRANTY (REGISTERED VERSION ONLY)
  156.     
  157.     THOUGHTFUL CREATIONS (TC) warrants that the magnetic diskette(s) which the
  158.     GENBOX computer SOFTWARE is recorded on and any DOCUMENTATION provided with
  159.     it are free from defects in materials and workmanship under normal use.  TC
  160.     warrants that the SOFTWARE itself will perform substantially in accordance
  161.     with the specifications set forth in the DOCUMENTATION provided with the
  162.     SOFTWARE. These warranties are made for sixty (60) days from the date of
  163.     original retail delivery to you or your company as the user.
  164.     
  165.     TC will replace any magnetic diskette or DOCUMENTATION which proves
  166.     defective in materials or workmanship without charge. TC will either
  167.     replace or repair any SOFTWARE that does not perform substantially in
  168.     accordance with the specifications set forth in the DOCUMENTATION with a
  169.     corrected copy of the SOFTWARE or corrective code. In the case of an error
  170.     in the DOCUMENTATION, TC will correct errors in the DOCUMENTATION without
  171.     charge by providing addenda or substitute pages.  If TC is unable to
  172.     replace defective DOCUMENTATION or a defective diskette or if TC is unable
  173.     to provide corrected SOFTWARE or corrected DOCUMENTATION within a
  174.     reasonable time, TC will either replace the SOFTWARE with a functionally
  175.     similar program or refund the fees paid for SOFTWARE.
  176.     
  177.     TC does NOT warrant that the functions contained in the SOFTWARE will meet
  178.     your requirements or that the operation of the SOFTWARE will be
  179.     uninterrupted or error free. ANY IMPLIED WARRANTIES COVERING THE DISKETTE,
  180.     THE DOCUMENTATION OR THE SOFTWARE PROGRAM INCLUDING ANY WARRANTIES OF
  181.     MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE ARE LIMITED IN DURATION
  182.     TO SIXTY (60) DAYS FROM THE DATE OF ORIGINAL RETAIL DELIVERY. An implied
  183.     warranty of merchantability means that the product will work normally and
  184.     an implied warranty of fitness means that a product  is suitable for the
  185.     use for which it is advertised.  Some states do not allow limitations on
  186.     how long an implied warranty lasts, so the above limitation may not apply
  187.     to you.
  188.     
  189.     TC SHALL NOT IN ANY CASE BE LIABLE FOR SPECIAL, INCIDENTAL, CONSEQUENTIAL,
  190.     INDIRECT OR OTHER SIMILAR DAMAGES ARISING FROM BREACH OF WARRANTY, BREACH
  191.     OF CONTRACT, NEGLIGENCE, OR ANY OTHER LEGAL THEORY EVEN IF TC OR OUR AGENT
  192.     HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. This means we are not
  193.     responsible for any costs incurred as a result of lost profits or revenue,
  194.     loss of use of the SOFTWARE, loss of data, costs of re-creating lost data,
  195.     the cost of any substitute program, claims by any party other than you, or
  196.     for other similar costs.  Some states do not allow the exclusion or
  197.     limitation of incidental or consequential damages, so the above limitation
  198.     or exclusion may not apply to you. This warranty is in lieu of all other
  199.     express warranties, whether oral or written. This warranty gives you
  200.     specific legal rights, and you may also have other rights which vary from
  201.     state to state.
  202.     
  203.     
  204. COPYRIGHT AND TRADEMARKS
  205.  
  206.     GENBOX Copyright (c) 1993-1994 by Thoughtful Creations. All rights reserved.
  207.     GENBOX is a trademark of Thoughtful Creations.
  208.  
  209.     GENBOX User's Manual Copyright (c) 1994 Thoughtful Creations.
  210.  
  211.     This product began with the need for a presentable chart for the Flight
  212.     Family Reunion, held at Lake Junaluska, North Carolina, in August, 1992.
  213.     The original program was then greatly expanded during the months
  214.     afterward.
  215.     
  216.     The author can be reached on CompuServe at [73740,1754], or by writing to
  217.     William T. Flight at the address given earlier.
  218.     
  219.     
  220. _______________________________________________________________________________
  221. ###############################################################################
  222.     
  223. CHAPTER 2: GETTING STARTED
  224.                           
  225.      Help Sections available in CHAPTER 2:
  226.      
  227.      <INSTALLATION>            Installation instructions for GENBOX.
  228.      <STARTING THE PROGRAM>    How to start the program.
  229.      <USING THE PROGRAM>       An overview of how to use the program.
  230.      <ONLINE HELP>             How to use the online help services.
  231.      <MENUS>                   How to use the menus.
  232.      <PERSON SELECTION>        How to select people to include on the charts.
  233. _______________________________________________________________________________
  234.     
  235. INSTALLATION
  236.     
  237.     The GENBOX distribution consists of the following files. Install the files
  238.     in the same directory on your hard disk:
  239.     
  240.         README.TXT       Introduction to GENBOX.
  241.         GENBOX.EXE       Main program.
  242.         FEDIT.EXE        Font editor utility. (REGISTERED VERSION only)
  243.         <GENBOX.OPT>     Options file.
  244.         <GENBOX.HLP>     Help file.
  245.         GENBOX.REG       Registration form. (SHAREWARE VERSION only)
  246.         GENBOX.VER       Release notes.
  247.         *.INI            Printer initialization files.
  248.         *.FNT            Font files, for use with landscape mode.
  249.         *.GED            Sample GEDCOM files, to experiment with.
  250.         
  251.     The registered version of GENBOX contains FEDIT.EXE, a utility for creating
  252.     and modifying fonts for use with GENBOX. It also contains additional
  253.     fonts and GEDCOM files.
  254.     
  255.     Before printing, you will need to set up GENBOX to work with your printer.
  256.     Select "Options", "Printing" and choose values as appropriate. The default
  257.     GENBOX options are for an HP-compatible printer on port LPT1, 17 characters
  258.     per inch, and 8 lines per inch.
  259.     
  260. STARTING THE PROGRAM
  261.     
  262.     At the DOS command prompt, type:
  263.     
  264.         GENBOX
  265.         
  266.     The program will start, displaying the main menu. First, select LOAD
  267.     GEDCOM FILE to load in your selected data file. Or, you may specify the
  268.     name of your GEDCOM file when you start the program, with the following
  269.     switch (Replace {GEDCOM filename} with the name of your own GEDCOM file):
  270.     
  271.         GENBOX -f {GEDCOM filename}
  272.         
  273.     If it is not in the current directory, specify the complete path.
  274.     
  275.     
  276.   Options File
  277.   
  278.     GENBOX starts by loading in the saved options from the file <GENBOX.OPT>.
  279.     OR, you may specify the name of a different options file to use when you
  280.     start the program, with the following switch: (replace {options filename}
  281.     with the name of your options file.)
  282.     
  283.         GENBOX -o {options filename}
  284.         
  285.     If you have made changes to options, you are asked when you exit GENBOX if
  286.     you would like to save your changes. If your type `Y' in response, you
  287.     will be prompted for the name of the file to save the options to, with the
  288.     default being GENBOX.OPT. If your type `N' in response to the question,
  289.     any changes made to the options will be discarded.
  290.     
  291.     
  292.   Advanced Text Modes
  293.   
  294.     If you are operating in a text mode larger than 80x25, you can inform
  295.     GENBOX of this when you start the program, and it will make use of the
  296.     larger screen area. This makes it possible to see a larger portion of your
  297.     charts at one time when in the viewer/editor. For example:
  298.     
  299.         GENBOX 80x50                - for 80 columns, 50 lines
  300.         GENBOX 132x43               - for 132 columns, 43 lines
  301.         GENBOX 160x64               - the largest screen size supported
  302.         
  303.     NOTE: specifying the screen resolution in columns and rows to GENBOX does
  304.     NOT change your screen resolution; it only informs GENBOX of the current
  305.     resolution in use. Consult the documentation that came with your display
  306.     adapter for how to select one of the advanced text modes.
  307.     
  308.     The DOS mode command may allow you to select the 50-line mode, as follows:
  309.     
  310.        MODE CON LINES=50
  311.        
  312.     In general, a VGA or SuperVGA monitor and adapter are required for advanced
  313.     display modes.
  314.     
  315.     
  316. USING THE PROGRAM
  317.     
  318.     In general, these are the steps you take when using GENBOX:
  319.     
  320.     1)  Choose `Load GEDCOM File' to load in your data.
  321.     2)  Choose `Options' to set things up BEFORE making your charts.
  322.     3)  Choose one of the chart production options.
  323.     4)  View your chart onscreen. You can also edit it.
  324.     5)  If your chart is not quite the way you want it, return to step (2).
  325.     6)  Print your chart and/or save your chart to a file.
  326.  
  327.     Remember: for most options to take effect, it is necessary to change the
  328.     options BEFORE making your chart.
  329.  
  330.     Other ways of using GENBOX are possible, as well. For example: if you have
  331.     saved a chart, you can choose the `View/Edit Saved Chart' option, and
  332.     proceed directly to step (4) in the list above.
  333.  
  334.     If any operation is taking too long, you can press the ESC key to abort.
  335.     
  336.     
  337. ONLINE HELP
  338.     
  339.     GENBOX is provided with a complete, context-sensitive, online help system.
  340.     From any prompt in the program, you may press the F1 KEY to get help
  341.     on the current prompt. All help information is stored in <GENBOX.HLP>,
  342.     which can also be read in any text editor or printed out for a hard copy.
  343.     
  344.     Once the help window appears, you can access help on related topics, or
  345.     on any help topic. Related topics will be keywords within the body of the
  346.     text that are marked with angle brackets, as in <MENUS>.
  347.     
  348.     Use the ARROW KEYS or TAB to highlight the desired keyword; press ENTER.
  349.     Press BACKSPACE to return to the previous help topic, or ESC to exit help. 
  350.     Press the F1 KEY within help for the <TOP> help window, for other topics.
  351.     
  352.     Press PGDN or PGUP to view help sections longer than one page. Notice that
  353.     the right-bottom window corner will be marked `PGDN' when there are more
  354.     pages. 
  355.  
  356.  
  357. MENUS
  358.     
  359.     The menus contain a number of options that can be selected by using the
  360.     ARROW KEYS to highlight the desired option, then pressing ENTER.
  361.     
  362.     Menu options usually have a marked "hotkey" that can be typed to
  363.     immediately select the corresponding menu option.
  364.     
  365.     Menus can be exited by pressing the ESC KEY.
  366.  
  367.     
  368. PERSON SELECTION
  369.    
  370.     People may be selected by entering either their <RIN> or their name.
  371.     If you do not know the RIN of the desired person, type in the person's
  372.     first name, followed by a space, and the person's last name. GENBOX
  373.     can recognize a number of partial name entries, as well. Examples:
  374.     
  375.     276                     - RIN
  376.     John Thomas Smith       - full name
  377.     John Thomas /Smith/     - full name, with surname marked. If surname
  378.                               contains spaces, the /marks/ are required.
  379.     John //                 - given name only
  380.     Smith                   - surname only
  381.     John                    - given name only; would try /John/ first
  382.     John Thomas             - given names only; would try John /Thomas/ first
  383.     Jo Smi                  - truncated given name and truncated surname
  384.     J S                     - truncated given name and truncated surname (This
  385.                                search may be slow, because everyone whose
  386.                                first name starts with `J' and last name starts
  387.                                with `S' will be matched)
  388.    *J T S                   - FAILS: GENBOX stores all given names as the
  389.                               "first name"; The first name in this example is
  390.                               `John Thomas', so shortened forms include `John
  391.                               Tho' and `John T' and `Jo', but NOT `J T'.
  392.     
  393.     
  394.     Each person with a matching name will be shown one at a time, until the
  395.     user confirms that the person displayed is the desired person. 
  396.     
  397.     
  398. _______________________________________________________________________________
  399. ###############################################################################
  400.     
  401. CHAPTER 3: MAIN MENU
  402.     
  403.     Help sections available in CHAPTER 3:
  404.      
  405.     <Load GEDCOM File>           Asks for <GEDCOM> file to load
  406.     <Options>                    Accesses the many configurable options
  407.     <Ancestors Box Chart>        Makes ancestors chart of selected person
  408.     <Descendants Box Chart>      Makes descendants chart of selected person
  409.     <Relatives Box Chart>        Makes relatives chart of selected person
  410.     <Everyone Box Chart>         Makes chart of everyone in the GEDCOM file
  411.     <Custom Box Chart>           Makes custom chart of multiple people
  412.     <View/Edit Saved Chart>      View, edit, or print a previously saved chart
  413.     <Help>                       Accesses the top level on online help
  414.     <Exit>                       Exits the program
  415.     
  416.  ______________________________________________________________________________
  417.     
  418.     
  419.   Load GEDCOM File
  420.      
  421.      Select this option to load in your <GEDCOM> file. Note that the five chart
  422.      production menu options are DISABLED until after a GEDCOM file is loaded.
  423.      
  424.      
  425.   Options   
  426.      
  427.     Select this option to access the many configurable options of the program.
  428.     See <CHAPTER 4: OPTIONS> for complete information.
  429.     
  430.     
  431.   Ancestors Box Chart
  432.      
  433.     The ANCESTORS box chart begins at the bottom with the person you select,
  434.     and extends upward to all of the ancestors of that person. 
  435.     
  436.     
  437.   Descendants Box Chart
  438.      
  439.     The DESCENDANTS box chart begins at the top with the person you select,
  440.     and extends downward to all of the descendants of that person.
  441.     
  442.     
  443.   Relatives Box Chart
  444.      
  445.     The RELATIVES box chart begins with the person you select, and finds
  446.     everyone in the GEDCOM file that has a "blood" relationship. First, all of
  447.     the ANCESTORS of the selected person are found; next, all of the
  448.     DESCENDANTS of these people are found. The Relatives Box Chart is like a
  449.     combination of the <Ancestors Box Chart> and the <Descendants Box Chart>.
  450.     Note that the starting person may end up near the top OR the bottom of the
  451.     chart, depending on what other data is present. All of the spouses of the
  452.     blood relatives are shown as well.
  453.     
  454.     Note: by a "blood" relationship, we mean those who generally would be blood
  455.     relatives; the program assumes children are the offspring of their parents.
  456.     Adoptions and other non-blood parent-child relationships are treated like
  457.     normal relationships.
  458.      
  459.      
  460.   Everyone Box Chart
  461.      
  462.     The EVERYONE box chart option produces a chart that has every person in
  463.     the GEDCOM file on it. This means that all portions of the chart will not
  464.     necessarily be connected; each connected portion will simply be placed
  465.     next to the previous connected portion. No starting name is needed to
  466.     produce this chart.
  467.      
  468.      
  469.   Custom Box Chart
  470.      
  471.     The CUSTOM box chart gives you great flexibility in producing a chart.
  472.     Instead of the descendants of one person, you can directly specify the
  473.     names of up to 255 people. The descendants of all of the <STARTING NAMES>
  474.     will be combined on one chart.
  475.     
  476.     In addition, you can limit the <MAXIMUM GENERATIONS> to include on the
  477.     chart. Descendants below this level will be omitted.
  478.     
  479.     What makes this chart most useful is that marriages between descendants of
  480.     different starting people are automatically detected. Connecting lines are
  481.     drawn; children of these marriages are shown only once.
  482.     
  483.     The starting people need not be in the same generation; if a marriage
  484.     between descendants of different starting people is detected, the entire
  485.     descendant trees will be shifted up/down in generations as appropriate.
  486.      
  487.      
  488.   View/Edit Saved Chart
  489.      
  490.     This option allows you to view a chart that was previously saved, with
  491.     EITHER the `Save Chart' or `Save as Text File' option under the
  492.     <VIEWER MENU>. menu. If the chart was saved as a text file, a temporary
  493.     file in <CHART FORMAT> will first be created.
  494.     
  495.     The chart may be viewed, edited, saved again, or printed.
  496.     
  497.     
  498.   Help       
  499.      
  500.     This option accesses the <TOP> level of the online help system, from where
  501.     help on any portion of the system may be accessed.
  502.      
  503.      
  504.   Exit       
  505.     
  506.     Choose this option to exit from GENBOX.
  507.     
  508. _______________________________________________________________________________
  509. ###############################################################################
  510.     
  511. CHAPTER 4: OPTIONS
  512.     
  513.     There are many user-settable options provided in GENBOX. Together, they
  514.     provide great flexibility in the format and content of the charts produced,
  515.     and in the operation of GENBOX itself. In general, options should be
  516.     changed BEFORE selecting one of the chart production options.
  517.  
  518.     The OPTIONS MENU provides access to the following option windows:
  519.      
  520.     <GENERAL>        Includes date and name formats and special options
  521.     <SIZES>          Chart, page, and box sizes
  522.     <HIGHLIGHTS>     Box highlighting: border choices based on surnames
  523.     <CHARACTERS>     Numeric codes for alternate graphics characters
  524.     <BOXES>          Box format and content
  525.     <TAGS>           List of all LEVEL 1 data tags and their settings
  526.     <VIEWER>         Movement choices when in the view/edit window
  527.     <PRINTING>       Printing options: port, emulation, pitch, orientation
  528.     
  529.     CHANGING OPTIONS: use the ARROW keys and TAB to move among the options on
  530.     each options window. Type in the new values. When done, press ENTER to
  531.     SAVE all changes made and exit. If you press ESC instead, the window will
  532.     be exited WITHOUT saving any changes made.
  533.    
  534.     NOTE: when ESC is pressed in the TAGS options window, only changes to the
  535.     current tag line are cancelled; changes to other tags are saved.
  536.     
  537.     The current values of all user-settable options are remembered after
  538.     GENBOX exits. They are written out to the OPTIONS FILE. The default name
  539.     for this file is <GENBOX.OPT>. Each time GENBOX is started, this file is
  540.     read in to set up the system.
  541.     
  542.     You may specify the name of a different options file to use when you start
  543.     the program (see <STARTING THE PROGRAM>).
  544.     
  545.     This feature is useful when you have determined a set of options preferred
  546.     for the generation of a specific chart that you produce frequently: you can
  547.     save the options to a separate file, such as SMITHDES.OPT, then specify
  548.     this file when starting GENBOX. You could maintain a small collection of
  549.     options files, one for each different chart type you frequently use. On
  550.     the other hand, you may find that there is only one set of options that
  551.     you prefer for all of your charts, and a single options file (the default)
  552.     is sufficient.
  553.     
  554. ______________________________________________________________________________
  555.  
  556.  
  557. GENERAL        
  558.  
  559.   Primary Person Names: Force to UPPERCASE? (Y)es (N)o:                       FP
  560.  
  561.     This option causes all <PRIMARY PERSON> names to be shown in UPPERCASE,
  562.     regardless of the actual case of the names in the <GEDCOM> file. To
  563.     select, type `Y' or `y'. To have primary names shown in the same case they
  564.     appear in the GEDCOM file, type `N' or `n'.
  565.  
  566.  
  567.   Spouse Names: Force to UPPERCASE? (Y)es (N)o:                               FS
  568.  
  569.     This option causes all <SPOUSE> names to be shown in UPPERCASE, regardless
  570.     of the actual case of the names in the <GEDCOM> file.
  571.  
  572.  
  573.   Date Format: (1)25 Dec 1993 (2)Dec 25 1993 (3)Dec 25, 1993:                 DF
  574.     
  575.     This option determines the appearance of dates that are stored in the
  576.     standard <GEDCOM> format. For choice (1), the day comes before the month;
  577.     for choices (2) and (3), the month comes before the day; for choice (3), a
  578.     comma is also placed after the day and before the year.  Dates that are in
  579.     nonstandard formats, such as `ABT 1020', are not affected.  Note: the
  580.     appearance of dates is also affected by the <Day/Month/Year Divider>
  581.     option, and the <Month Format> option. 
  582.    
  583.    
  584.   Day/Month/Year Divider: ( ); (/); (-): -                                    DM
  585.     
  586.     This option specifies the dividing character to be shown in dates between
  587.     the Day and the Month, and also before the Year. Thus, if the <Date Format>
  588.     was (1), this option could provide the following variations: 25 Dec 1993;
  589.     25/Dec/1993; 25-Dec-1993.
  590.        
  591.     Choices are not limited to those shown; any character may be used.
  592.     
  593.    
  594.   Month Format: (1)12 (2)Dec (3)DEC (4)December (5)DECEMBER:                  MF
  595.     
  596.     This option determines how the MONTH part of standard dates are displayed.
  597.     The months of dates not in standard <GEDCOM> format are not affected.
  598.     
  599.     
  600.   Language for Months: (E)nglish (G)erman                                     LL
  601.     
  602.     This option controls the language of the month names displayed. When
  603.     (G)erman is selected, the month abbreviations MRZ (March), MAI (May),
  604.     OKT (October), and DEZ (December) are recognized, in addition to the normal
  605.     month abbreviations.
  606.    
  607.    
  608.   Line-Drawing Character Set: (P)C Codes; (A)lternate Codes:                  GC
  609.     
  610.     This option determines the character set used for the display of the box
  611.     borders and connecting link lines in the chart. The "PC" set is preferred,
  612.     because the lines are smoothly connected, using the special graphics codes
  613.     starting at code 179 and continuing through code 223. If your printer does
  614.     not support the PC character set, select the (A)lternate Codes option. This
  615.     allows you to directly specify the symbols to use for drawing the lines and
  616.     boxes. To select the alternate characters to use for line-drawing, choose
  617.     <CHARACTERS>.
  618.     
  619.  
  620.   Alternate Codes: Apply when (M)aking Chart or (P)rinting:                   CT
  621.     
  622.     This option works only when the (A)lternate Codes option is selected. This
  623.     option allows you to choose WHEN the alternate characters are applied: when
  624.     the chart is MADE, or when the chart is PRINTED.
  625.    
  626.     If applied when the chart is MADE, then the Viewer will show the alternate
  627.     characters, letting you "preview" the character translation. You can save
  628.     the chart, with the alternate codes in place. You can even add PC graphics
  629.     characters to the chart, because no further translation will take place.
  630.     
  631.     If your GEDCOM data uses foreign symbols that have the same codes as some
  632.     of the PC graphics codes used by GENBOX, then by choosing application of
  633.     the alternate characters when the chart is MADE, these foreign symbols in
  634.     the data will not be affected. Of course, this is only useful to you if
  635.     your printer is initialized to print these codes as the correct foreign
  636.     symbols.
  637.     
  638.     If you instead select to apply the alternate characters when (P)rinting
  639.     the chart, the normal PC codes will be used when the chart is produced.
  640.     The Viewer will show the normal PC graphics characters for box borders and
  641.     lines. If the chart is saved, it is saved with the PC graphics characters.
  642.     But when the chart is PRINTED, every occurrence of the PC graphics
  643.     characters will be substituted with the corresponding character from the
  644.     Alternate Character Set, as defined on the <CHARACTERS> window.
  645.     
  646.        
  647.   Include Page Numbers? (Y)es (N)o:                                           PN
  648.     
  649.     If this option is selected, <PAGE NUMBERS> will be printed on the top-left
  650.     corner of every page on the charts.
  651.     
  652.     If NOT selected, there will still be a `B' in the top-left corner of the
  653.     first page in the second row, to tell the GENBOX Viewer/Editor where the
  654.     second row of pages starts.
  655.    
  656.    
  657.   Include Key Page? (Y)es (N)o:                                               KP
  658.     
  659.     The Key Page functions both as a chart title page and as a key for reading
  660.     the chart. The title section contains the type of chart produced and the
  661.     people selected to produce the chart. If a SUBM record was present in the
  662.     GEDCOM file, the name of the submitter is included.
  663.     
  664.     The key section contains a list of all of the tag labels that appear on
  665.     the chart, accompanied with the tag description data.
  666.     
  667.     The key page is logically placed on the bottom-right page of the chart.
  668.     Thus, when printing out the chart, it will appear at the END of the LAST
  669.     row of pages.
  670.     
  671.     
  672.   Minimize Box Straddle? (Y)es (N)o:                                          SB
  673.     
  674.     Box widths in GENBOX can vary, depending on data available for each person.
  675.     With varying box widths, some boxes will end up extending across a page
  676.     break, with the left part of the box on one page, and the right part of the
  677.     box on the next page.
  678.     
  679.     While box straddle can not be avoided, this option can be chosen to
  680.     minimize it: when set to `Y', boxes that are "free to move" will be shifted
  681.     left or right, in order to appear completely on one page. A box is "free to
  682.     move" if there is not a box immediately adjacent to it. If there is
  683.     insufficient space to completely move the box off of the page break, its
  684.     position is not changed.
  685.     
  686.     Of course, this movement will throw off the centering of boxes over
  687.     their children boxes, so it is a compromise. If you plan to trim pages and
  688.     mount your chart, you may prefer to leave this option set to (N)o.
  689.     
  690. _______________________________________________________________________________
  691.  
  692.     
  693. SIZES          
  694.    
  695.   Page Width, in cols (xxx = optimum):                                        PW
  696.     
  697.     This option determines the printable width of the page. Margins will
  698.     reduce the printed portion of the page from this value. The "optimum" value
  699.     shown is a suggestion, based on the characters per inch selected.
  700.     
  701.     
  702.   Page Height, in rows (xx = optimum):                                        PH
  703.     
  704.     This option determines the printable height of the page. Margins will
  705.     reduce the printed portion of the page from this value. The "optimum" value
  706.     shown is a suggestion, based on the lines per inch selected; or if printing
  707.     in landscape mode, it is based on the font selected, whether the font
  708.     height is being doubled, and the paper size.
  709.     
  710.     
  711.   Chart Top Margin (rows):                                                    CT
  712.     
  713.     This option is used to set the chart top margin, in rows. Usually, this
  714.     value will be 0. A value greater than zero may mean fewer generations will
  715.     fit on the first row of pages than on subsequent page rows.
  716.     
  717.     
  718.   Chart Left Margin (cols):                                                   CL
  719.     
  720.     This option is used to set the chart left margin, in rows. Usually, this
  721.     value will be 0. A chart left margin simply shifts the entire chart to the
  722.     right, creating blank space on the left side of the first page in each row.
  723.     
  724.     
  725.   Page Top Margin (rows):                                                     TM
  726.     
  727.     This option determines the top margin on every page, in rows. Usually, it
  728.     is set to 0.
  729.     
  730.     
  731.   Page Bottom Margin (rows):                                                  BM
  732.     
  733.     This option determines the MINIMUM bottom margin on every page, in rows.
  734.     The actual bottom margin may be larger, depending on box height, page
  735.     height, and number of generations being printed. Usually, the page bottom
  736.     margin is set to 0.
  737.     
  738.     
  739.   Page Left Margin (cols):                                                    LM
  740.     
  741.     This option determines the page left margin, in columns. Usually, it is
  742.     set to 0.
  743.    
  744.    
  745.   Page Right Margin (cols):                                                   RM
  746.     
  747.     This option determines the page right margin, in columns. Usually, it is
  748.     set to 0.
  749.     
  750.     
  751.   Page Horizontal Overlap (cols):                                             OL
  752.     
  753.     This option is useful when the pages are to be trimmed before mounting.
  754.     When greater than zero, it creates an "overlap" area, where the first
  755.     few columns on each page are a repeat of the last few columns on the
  756.     previous page.
  757.     
  758.     
  759.   Box Height (inside rows):                                                   BH
  760.     
  761.     This option determines the height of all boxes on the chart. The default
  762.     value is 8 rows. The box top and bottom, plus 3 link rows, make the
  763.     total height for each generation on the chart to be 5 + BOX HEIGHT. 
  764.     
  765.     For best results, consider the page height and page top/bottom margins
  766.     when choosing a box height. Since only whole generations will be put on a
  767.     page, some box heights will result in wasted rows at the bottom of every
  768.     page. Formula for generations per page:
  769.     
  770.         (Page Height - Top Margin -  Bottom Margin) / (Box Height + 5)
  771.         
  772.     The wasted lines will be the remainder from this division. FOR EXAMPLE: if
  773.     you have a page height of 66 rows, no top/bottom margins, and a Box Height
  774.     of 8 rows: 66/(8+5) = 5 generations per page, with one blank line. If you
  775.     have an HP-compatible laser printer, set Lines Per Inch to 8 and Page
  776.     Height to 84: then, you can specify Box Height = 9: 84/(9+5) = 6
  777.     generations per page, exactly.
  778.     
  779.     
  780.   Box Minimum Width (inside cols):                                            MN
  781.     
  782.     This option determines the minimum box width, in columns. Usually, it is
  783.     set to 1.
  784.     
  785.     
  786.   Box Maximum Width (inside cols):                                            MX
  787.     
  788.     This option determines the maximum box width, in columns. Usually, it is
  789.     set to 60; values up to 200 are supported.
  790.     
  791.     
  792.   Minimum Box Separation (cols):                                              BS
  793.     
  794.     This option determines how closely boxes are placed next to each other.
  795.     The default is 1 column.
  796.  
  797. _______________________________________________________________________________
  798.  
  799.  
  800. HIGHLIGHTS              
  801.  
  802.     GENBOX supports the selective highlighting of boxes, based on surname.
  803.     This feature can be useful when producing charts for family reunions: all
  804.     boxes on the chart with the family name can be highlighted. Boxes with
  805.     either a <PRIMARY PERSON> or <SPOUSE> having the selected surname will be
  806.     highlighted. The type of highlighting is selected by setting the border
  807.     attributes for normal boxes and highlighted boxes differently.
  808.     
  809.    
  810.   Highlight boxes with last name:                                             HN
  811.     
  812.     Enter the surname desired in this field. All boxes that have a surname
  813.     that BEGINS with this text will be highlighted; thus, it is not necessary
  814.     to type the full surname.
  815.     
  816.     
  817.   Use Double-line Borders on Normal Boxes? (Y)es (N)o:                        DN
  818.     
  819.     If set to (Y)es, normal boxes will be shown with a double-line box border.
  820.     If set to (N)o, a single-line box border will be used.
  821.     
  822.     
  823.   Include Shadows on Normal Boxes? (Y)es (N)o:                                SN
  824.     
  825.     If set to (Y)es, normal boxes will include a simulated shadow, placed
  826.     along the top and left edges of the box. If set to (N)o, normal boxes will
  827.     not have a shadow.
  828.     
  829.     
  830.   Double-line Borders on Highlight Boxes? (Y)es (N)o:                         DH
  831.     
  832.     If set to (Y)es, highlight boxes will be shown with a double-line box
  833.     border. If set to (N)o, a single-line box border will be used.
  834.     
  835.     
  836.   Shadows on Highlight Boxes? (Y)es (N)o:                                     SH
  837.     
  838.     If set to (Y)es, highlight boxes will include a simulated shadow, placed
  839.     along the top and left edges of the box. If set to (N)o, highlight boxes
  840.     will not have a shadow.
  841.     
  842.     
  843. _______________________________________________________________________________
  844.  
  845.  
  846. CHARACTERS            
  847.  
  848.   All Fields                                                             CA - CY
  849.   
  850.     This window contains the numeric codes for the alternate chararacter set.
  851.     These characters can be used instead of the normal PC character codes, for
  852.     drawing the box borders and connecting lines.
  853.     
  854.     The label of each field contains the PC graphic symbol and decimal value.
  855.     The data entry field contains the DECIMAL code of the alternate character,
  856.     range 1-255.  If the value typed in the field is the same as the PC code,
  857.     then the normal PC code will be used; otherwise, the value represents a
  858.     different character.
  859.     
  860.     The left column of symbols are used for connecting lines and single-line
  861.     box borders. The right column of symbols are used for double-line box
  862.     borders and shadows.
  863.     
  864.     The defaults for these fields are appropriate selections taken from the
  865.     standard ASCII character set, in the range 32-127. If you make changes
  866.     and later decide you want to return to the defaults, an easy way to do
  867.     this is to edit your <GENBOX.OPT> options file: delete all the lines
  868.     that start with CHARACTER. The next time you start GENBOX, the defaults
  869.     will appear.
  870.     
  871.     Normally, you will use the alternate characters only when your printer does
  872.     not support the PC character set. However: it can also be used to select
  873.     alternate PC codes, for added "style". First: set all alternate codes to be
  874.     the same as the PC codes shown. Next: consult the PC character set table in
  875.     your DOS manual, under "Code-Page Tables". Select alternate characters and
  876.     type in their decimal value next to the codes you wish to replace. For
  877.     example: you can put added "zing" in highlighted boxes by changing the
  878.     double horizontal-bar character (═) to the heart character: Type "3" in
  879.     the data entry field next to character code 205.
  880.     
  881.  
  882. _______________________________________________________________________________
  883.  
  884.     
  885. BOXES           
  886.    
  887.   Allow line wrap? (Y)es (N)o:                                                LW
  888.     
  889.     This option determines how long data items are handled. If set to (N)o,
  890.     they can extend up to the maximum box width, then they are truncated.  If
  891.     set to (Y)es, data items are wrapped onto multiple lines. Wrapping will
  892.     occur on spaces or after any punctuation character. If the data item has a
  893.     segment wider than the maximum box width that does not contain spaces or
  894.     punctuation, it will be wrapped at the maximum box width.
  895.     
  896.     
  897.   Right-justify wrapped lines? (Y)es (N)o:                                    RJ
  898.     
  899.     When set to (Y)es, wrapped lines are right-justified. This formatting
  900.     option may make it easier to distinguish line continuations than when all
  901.     lines are left-justified.
  902.     
  903.     
  904.   Center all lines? (Y)es (N)o:                                               CJ
  905.     
  906.     When set to (Y)es, all lines in the box are centered. This option
  907.     overrides the setting of the <Right-justify wrapped lines?> option.
  908.     
  909.     
  910.   Show primary person's RIN in top-right corner? (Y)es (N)o:                  CI
  911.     
  912.     This option determines whether the <RIN> of the <PRIMARY PERSON> is shown.
  913.     If selected, it appears on the box border, in the top-right corner.
  914.     
  915.     
  916.   Show spouse's RIN in bottom-right corner? (Y)es (N)o:                       CS
  917.     
  918.     This option determines whether the <RIN> of the <SPOUSE> is shown. If
  919.     selected, it appears on the box border, in the bottom-right corner.
  920.     
  921.     
  922.   Show family's MRIN in bottom-left corner? (Y)es (N)o:                       CF
  923.    
  924.     This option determines whether the <MRIN> for the family is shown. If
  925.     selected, it appears on the box border, in the bottom-left corner.
  926.     
  927.     
  928.   Priority Person Bias: (1) None; (2) Priority; (3) Exclusive:                BP
  929.     
  930.     This option determines how <PRIORITY PERSON> biasing is performed. Priority
  931.     person biasing is a priority system that is in addition to the normal data
  932.     priority system, which is determined by the settings under <TAGS>. (Be
  933.     careful not to confuse PRIORITY PERSON with <PRIMARY NAME>; the priority
  934.     person in a box may or may not be the primary name person.)
  935.     
  936.     If `Priority' is selected, preference will be given to priority person
  937.     information; if room remains in the box, information from the non-priority
  938.     person will be included. GENBOX achieves this by adding 100 to the rank
  939.     values for all non-priority person's data types that NORMALLY have a value
  940.     of 2 or GREATER: data types with a rank of 1 or -1 are NOT adjusted. This
  941.     permits the non-priority person's NAME (with a rank value of 1) to still be
  942.     included in the box, as well as any "forced" (rank = -1) fields.
  943.     
  944.     If `Exclusive' is chosen, all data types from the non-priority person with
  945.     a rank value of 2 or GREATER are EXCLUDED from the box, even if space would
  946.     otherwise permit additional information to be shown. Since the NAME data
  947.     type is normally ranked 1, this results in only the NAME of the non-
  948.     priority person being included, with other data types omitted. This can
  949.     result in reduced box widths, making for a narrower chart.
  950.     
  951.     IF `None' is chosen, data from both persons will be ranked normally in all
  952.     boxes.
  953.     
  954.     
  955.   Tags LEVEL: treat col as subfield (I)nclusion or (P)riority:                TL
  956.     
  957.     This option controls the interpretation of the LEVEL settings column on the
  958.     <TAGS> options window. When set to (I)nclusion, the LEVEL value for each tag
  959.     is taken to be fixed: only subfield data up to the indicated level will be
  960.     included, even if other data is available. This subset of data will then be
  961.     treated as one "data item"; if there is not sufficient space in the box to
  962.     show the whole item (after omitting any lower-ranked data items), it will
  963.     be omitted entirely.
  964.     
  965.     If set to (P)riority, the level value serves as the MINIMUM: if space
  966.     permits and more subfield data is available, it will be included.  When
  967.     space is tight, the "optional" subfield data will be dropped first; if
  968.     there is still not enough space, the entire data item will be dropped.
  969.     
  970.     
  971.   Place Names: Remove extra commas? (Y)es (N)o:                               KC
  972.     
  973.     GEDCOM data sometimes has extra commas in place names. Place names are
  974.     divided into a level hierarchy, as in `city, county, state, country'. If
  975.     the county data is not present, the place name may appear as `city,, state,
  976.     country'.  When this option selected, GENBOX will detect the double comma
  977.     `,,' and replace it with a single comma.
  978.     
  979.     
  980.   Add space after commas if missing? (Y)es (N)o:                              AS
  981.  
  982.     This option will add a space after commas in place names, if there is not
  983.     already a space.
  984.     
  985.     
  986.   Ignore Quality Assessment values? (Y)es (N)o:                               QA
  987.     
  988.     If selected, all Quality Assessment values (GEDCOM subfield tag QUAY) will
  989.     be omitted from the chart, even for data items with a LEVEL value of 9 (all
  990.     data). In GEDCOM files, Quality Assessment Values are used to indicate the
  991.     reliability of the associated data: they are a number ranging from 0
  992.     (unreliable) to 3 (direct or primary evidence). When they appear after many
  993.     data items, they can clutter up the appearance of the chart. Select this
  994.     option to prevent them from being included.
  995.     
  996.     If this option is not selected, the Quality Assessment values will be
  997.     included after the data items they affect (provided the tag has a LEVEL
  998.     value of 9), with a prefix of `Q' added.
  999.     
  1000. _______________________________________________________________________________
  1001.  
  1002.     
  1003. VIEWER             
  1004.    
  1005.   Horizontal Page Advance (cols):                                             SW
  1006.     
  1007.     This option determines how far the cursor advances in the left/right
  1008.     directions when the HOME/END keys are pressed. If this option is set to 0,
  1009.     a value equal to approximately one-half the screen width will automatically
  1010.     be used. You may wish to set this to a smaller or larger value. (You can
  1011.     also use the CTRL-LEFT and CTRL-RIGHT keys to move left and right on the
  1012.     chart display; these keys move the cursor by one screenwidth.)
  1013.     
  1014.     
  1015.   Vertical Page Advance (rows):                                               SH
  1016.     
  1017.     This option determines how far the cursor advances in the up/down
  1018.     directions when the PGUP/PGDN keys are pressed. If this option is set to 0,
  1019.     a value equal to approximately one-half the screen height will
  1020.     automatically be used. You may wish to set this to a smaller or larger
  1021.     value. (You can also use the CTRL-PAGEUP and CTRL-PAGEDOWN keys to move up
  1022.     and down on the chart display; these keys move the cursor by one screen
  1023.     height.)
  1024.     
  1025.     
  1026.   Side-Side Page Break Character:                                             HB
  1027.     
  1028.     This option determines which character is used to represent page breaks
  1029.     between pages that are side-by-side (left/right) when in the viewer. The
  1030.     default is the vertical bar, `|'. Note that the page break characters are
  1031.     just part of the view; they are not part of the chart, and do not appear
  1032.     when the chart is printed.
  1033.     
  1034.     
  1035.   End-End Page Break Character:                                               VB
  1036.     
  1037.     This option determines which character is used to represent page breaks
  1038.     between pages that are end-to-end (above/below) when in the viewer. The
  1039.     default is the dash, `-'. Note that the page break characters are just part
  1040.     of the view; they are not part of the chart, and do not appear when the
  1041.     chart is printed.
  1042.     
  1043.     
  1044.   Smooth Vertical Scrolling? (Y/N):                                           SS
  1045.     
  1046.     If set to (Y)es, the PGUP/PGDN keys will result in a smooth scroll of the
  1047.     chart, when the cursor moves off the current view. If this is unacceptably
  1048.     slow for your system, set this option to (N)o; the chart will be instantly
  1049.     updated in its new position.
  1050.     
  1051. _______________________________________________________________________________
  1052.  
  1053.     
  1054. TAGS            
  1055.    
  1056.     The TAGS options window provides for sophisticated handling of GEDCOM data.
  1057.     Individual data types can be prioritized, ordered, labeled, described,
  1058.     truncated, and selectively included. With a little practice, you should be
  1059.     able to get just the subset of data you want, ordered and labeled the way
  1060.     you want it to be.
  1061.     
  1062.     It is helpful to think of GEDCOM data as organized along two dimensions:
  1063.     the TYPE of data being own dimension, and SUBFIELDS of the data type as the
  1064.     other dimension. The data type corresponds to GEDCOM LEVEL 1 tags, such as
  1065.     NAME, BIRT, DEAT, OCCU, MARR. For each of these data types, a number
  1066.     of subfields may be present, such as TEXT, DATE, PLAC, ADDR, NOTE. The
  1067.     subfields correspond to GEDCOM LEVEL 2 tags and higher. Not all data types
  1068.     can have all subfields; NAME, for example, is limited to just TEXT.
  1069.     
  1070.     On the TAGS options window, each row is an individual data type,
  1071.     corresponding to a LEVEL 1 GEDCOM tag. Each row contains six data values:
  1072.     <Tag>, <Name>, <Label>, <Order>, <Rank>, and <Level>.
  1073.     
  1074.     
  1075.   Tag
  1076.   
  1077.     The TAG value contains the actual LEVEL 1 GEDCOM tag. Only tags that have
  1078.     an entry here will be processed by GENBOX. If other LEVEL 1 tags in the
  1079.     GEDCOM file are encountered when producing a chart, they will automatically
  1080.     be added to the list, ready for you to set the other five values for each.
  1081.   
  1082.     
  1083.   Name
  1084.   
  1085.     The NAME value should contain descriptive text, describing what the data
  1086.     for this tag represents. This descriptive text will appear on the Key
  1087.     Page when a chart is produced, if the Key Page option is enabled.
  1088.     
  1089.     
  1090.   Label
  1091.   
  1092.     The LABEL value contains the label text that will appear in the box before
  1093.     the associated data. The BIRT tag may have a label of `b.' or maybe just
  1094.     `b'. No label is required; typically, the NAME tag has no label, for
  1095.     example. Labels that actually appear on a chart will also be listed with
  1096.     the corresponding descriptive text on the Key Page, if the Key Page option
  1097.     is enabled.
  1098.     
  1099.     
  1100.   Order
  1101.   
  1102.     The ORDER value determines how tag data is organized in the box. Data for
  1103.     tags with order=1 are listed before data for tags with order=2, and so on.
  1104.     If data for several tags appearing in a box have the same order value, they
  1105.     will be sub-ordered according to their order in the TAGS options window. 
  1106.     
  1107.     An ORDER value of 0 is considered non-ordered: it is treated the same as an
  1108.     order of 99. New tags are given an order of 0, drawing attention to the
  1109.     fact that they have not been ordered yet.
  1110.     
  1111.     Order values less than 0 are special; see <RANK ADVANCEMENT>.
  1112.     
  1113.   Rank
  1114.   
  1115.     The RANK value determines the priority of tags. If there is more data
  1116.     available than will fit in a box, the rank value will be used to determine
  1117.     which data items to leave out. A rank value of 1 is typically the highest
  1118.     priority, and 99 the lowest.
  1119.     
  1120.     Rank values are not necessarily fixed. It is possible for the effective
  1121.     rank on some data types to be advanced (changed to a smaller number), if
  1122.     data on some other data type is absent; see <RANK ADVANCEMENT>.
  1123.     
  1124.     A RANK value of -1 is actually a higher priority than a value of 1: it is
  1125.     used to FORCE a data type to ALWAYS be included in every box, even if no
  1126.     corresponding data is present. This feature is useful when a chart will be
  1127.     edited/written on after it is produced, and extra space to add data is
  1128.     desired.
  1129.     
  1130.     A RANK value of 0 is considered non-ranked: it is treated the same as a
  1131.     value of 99. New tags are given a rank of 0, drawing attention to the fact
  1132.     that they have not been ranked yet.
  1133.     
  1134.   Level
  1135.   
  1136.     The LEVEL value determines the amount and types of SUBFIELD data that will
  1137.     be presented. It also serves as an ON/OFF switch: any tag with a LEVEL
  1138.     value of zero will be turned OFF: no data corresponding to this tag will
  1139.     appear on the chart.
  1140.     
  1141.     Data in a GEDCOM file is organized into a hierarchy, with the level value
  1142.     as the first number on each line. The data for each PERSON starts at level
  1143.     0. Each different event record stored for the person, such as birth and
  1144.     death, begins at level 1. Data related to particular events immediately
  1145.     follow, at level value 2. This includes things such as place names and
  1146.     dates. Place names can have additional subfields beginning at level 3, for
  1147.     information such as addresses or sites. In general: If you are looking at
  1148.     data item `D' at level Y, you look back in the file for a line beginning
  1149.     with a level value of Y-1. This is the data item that the data item you
  1150.     started with modifies.
  1151.     
  1152.     Each GENBOX LEVEL value, from 1 through 9, represents an increasing amount
  1153.     of subfield data to include for the current data tag. At level 9, ALL data
  1154.     in the GEDCOM file associated with the corresponding tag is included, for
  1155.     each person. Caution: do not confuse GENBOX LEVEL values with GEDCOM data
  1156.     levels. The assignment of GEDCOM subfields to LEVEL values is as follows:
  1157.     
  1158.         0    (no data)
  1159.         1    Label only
  1160.         2    Text             GEDCOM level 1 text (immediately follows tag)
  1161.         3    TYPE             GEDCOM level 2 event descriptor
  1162.         4    DATE/AGE         GEDCOM level 2 date and age subfields
  1163.         5    PLAC             GEDCOM level 2 place text
  1164.         6    SITE/ADDR        GEDCOM level 3+ address and site information
  1165.         7    CAUS/RELI        GEDCOM level 2 text for CAUSE, RELIGION
  1166.         8    NOTE             GEDCOM level 2+ notes
  1167.         9    all data         Includes quality codes, change dates, sources
  1168.  
  1169.     A normal LEVEL value to use is 5: this will include dates and place names,
  1170.     but leave out addresses, quality codes, sources, and other "special"
  1171.     subfield types. If the current tag does not normally have all the subfields
  1172.     possible, no harm is caused by a large level value: it is always okay to
  1173.     use 5 as a level value, even for the NAME tag, for example.
  1174.     
  1175.     All selected subfields are appended with a space separator, in the order
  1176.     the data appears in the GEDCOM file.
  1177.     
  1178.     The interpretation of the LEVEL field is affected by the LEVEL Subfield/
  1179.     Inclusion setting; see <BOXES>.
  1180.     
  1181.     NOTE: some data normally appearing as subfields may appear at level 1,
  1182.     such as ADDR and NOTE; when they do, they are treated as normal level 1
  1183.     tags. Thus, it is possible to include NOTE data at this level while
  1184.     omitting NOTE data at higher levels that are attached to subfields.
  1185.     
  1186. _______________________________________________________________________________
  1187.  
  1188.     
  1189. PRINTING           
  1190.    
  1191.  
  1192.   Printer Port: (1) LPT1; (2) LPT2; (3) LPT3; (4) LPT4:                       LP
  1193.     
  1194.     Use this option to tell GENBOX which parallel printer port is connected to
  1195.     your printer. If your printer is connected to a SERIAL port, you will need
  1196.     to use the DOS MODE command to redirect output from a parallel port to the
  1197.     serial port, with a command such as:
  1198.     
  1199.         mode lpt1 = com1
  1200.     
  1201.     GENBOX prints directly to the parallel port selected. For proper operation,
  1202.     do NOT use the system MODE LPT command to specify a retry action to take
  1203.     when time-out errors occur. GENBOX handles timeout errors automatically.
  1204.  
  1205.   
  1206.   Printer Emulation: (1)HP (2)Epson (3)Epson-LQ850 (4)IBM (0)None             PE
  1207.   
  1208.     Use this option to tell GENBOX what type of printer you have. Most printers
  1209.     support one of these emulations. In order to print in landscape mode, you
  1210.     will need to have a printer that supports one of the emulations 2, 3, or 4.
  1211.     For example: if you have an IBM Proprinter X24E, choose (4)IBM. If you have
  1212.     a Panasonic KX-P2023, choose (3)Epson-LQ850.
  1213.     
  1214.     
  1215.   Paper Size:  (1) Letter  (2) Wide  (3) Legal  (4) A4                        PS
  1216.   
  1217.     Use this option to tell GENBOX what size paper you have loaded into your
  1218.     printer. It is used to recommend optimum page widths and heights.  
  1219.     
  1220.     
  1221.   Printing Blank Pages: (S)kip; (P)rint:                                      PB
  1222.     
  1223.     Large charts may have completely blank pages. If you wish these pages to
  1224.     be skipped when printing, set this option to (S)kip. Note that it will be
  1225.     up to you, then, to figure out how to assemble the chart; the number of
  1226.     pages printed may vary from row to row.
  1227.     
  1228.     NOTE: if "Include Page Numbers" is selected, no page will be considered
  1229.     blank.
  1230.     
  1231.     
  1232.   Form Feeds at end of Pages: (O)mit; (I)nclude:                              FF
  1233.     
  1234.     Some printers automatically form-feed after the last line is printed on a
  1235.     page. If your size options have you printing on the last page line, and
  1236.     you are getting extra blank pages after every good page, set this option
  1237.     to (O)mit. Otherwise, set this option to (I)nclude.
  1238.     
  1239.     
  1240.   Printer Initialize File:                                                    PI
  1241.  
  1242.     This option can hold the name of a printer initialization file that will be
  1243.     sent to the printer before each chart print operation. It can contain font
  1244.     style, print quality, and other initialization information. NO PRINTER
  1245.     INITIALIZATION FILE IS NECESSARY. GENBOX will always send the necessary
  1246.     initialization codes, according to the selected printer emulation. For
  1247.     HP-compatible printers, the provided HPLASER.INI selects the PC-8 symbol
  1248.     set. For Epson-compatible printers, the EPSON.INI file can be used to
  1249.     select letter-quality mode. The IBM.INI file sets letter-quality mode for
  1250.     IBM Proprinter-compatible printers. If your printer does not support the
  1251.     HP, EPSON, or IBM emulations, your printer initialization file becomes more
  1252.     important. You will need to consult the manual that came with your printer
  1253.     to determine what initialization codes, if any, you should use, then use a
  1254.     text editor to create the file.
  1255.     
  1256.     
  1257.   Printer Terminate File:                                                     PT
  1258.     
  1259.     This option can hold the name of a printer termination file that will
  1260.     be sent to the printer after the completion of each chart print operation.
  1261.     Generally, it would be used to reset the printer to its previous state.
  1262.     Normally, no termination file is necessary.
  1263.     
  1264.     
  1265.   CPI--Chars per Inch for Portrait Mode: (0=don't set)                        PP
  1266.   
  1267.     This option determines the character pitch when printing charts in portrait
  1268.     (normal) orientation. If a printer emulation is specified, this setting
  1269.     will be used to send the appropriate control commands to the printer to set
  1270.     the number of characters per inch. If this is set to 0, or if the emulation
  1271.     is set to 0, no command is sent. This option also determines the optimum
  1272.     number of characters that will fit on a line; if this value is different
  1273.     from the current page width setting, a cautionary message will be displayed
  1274.     when the PRINTING options window is closed.
  1275.     
  1276.     
  1277.   LPI--Lines per Inch for Portrait Mode: (0=don't set)                        PL
  1278.   
  1279.     This option determines the line spacing when printing charts in portrait
  1280.     mode. Normal values are 6 or 8 lines per inch. If this is set to 0, or if
  1281.     the printer emulation is set to 0, no command will be sent to the printer.
  1282.     This value also determines the optimum number of lines that will fit on a
  1283.     page; if the current page height setting is different from the optimum
  1284.     value, a cautionary message will be displayed when the PRINTING options
  1285.     window is closed.
  1286.     
  1287.     
  1288.   Landscape Mode: (EPSON/EPSON-LQ850/IBM only)  (Y)es: (N)o:                  LP
  1289.   
  1290.     GENBOX can print charts in continuous "strips" in landscape (sideways)
  1291.     orientation on continuous-paper printers. This is accomplished by using
  1292.     special fonts, printed in graphics mode. Set this option to (Y)es to print
  1293.     in landscape mode.
  1294.     
  1295.     
  1296.   Font File:                                                                  LF
  1297.   
  1298.     This option contains the filename for the font to be used for landscape
  1299.     printing. A number of fonts are supplied with GENBOX; you can use the
  1300.     "FEDIT" utility to create additional fonts or modify existing ones. When
  1301.     printing in landscape mode, the font chosen determines how many lines will
  1302.     fit (sideways) on each chart strip; if this optimum value differs from the
  1303.     specified page height, a cautionary message will be displayed when the
  1304.     PRINTING options window is closed. The number of characters per inch is
  1305.     also determined by the font choice; however, since pages are printed in
  1306.     continuous strips, the page width setting is not important the printing of
  1307.     the chart; the chart will look the same whether the page width is 50
  1308.     characters or 100 characters.
  1309.     
  1310.     
  1311.   Pin Mode: (1) 8-Pins  (2) 24-Pins                                           PM
  1312.   
  1313.     This option controls the graphics commands that will be used in landscape
  1314.     printing. If your printer supports 24-pin printing, select (2) for the best
  1315.     results. In general: any font can be used in either 8-pin or 24-pin
  1316.     printing; for 8-pin printing, the pins are farther apart, so the chart will
  1317.     be about three times as wide. This may make some fonts look "stretched".
  1318.     
  1319.     
  1320.   Dots per Inch: (1) 60 DPI  (2) 120 DPI                                      DP
  1321.   
  1322.     This option controls the graphics print density when printing in landscape
  1323.     mode. Most printers support both densities; choose 120 dots per inch (2)
  1324.     for best results. This option affects the number of lines that will fit on
  1325.     a page; when (2) is selected, twice as many lines will fit on the page.
  1326.     
  1327.     
  1328.   Double Font Height?  (Y)es  (N)o                                            DF
  1329.   
  1330.     This option will cause the font selected in landscape mode to be printed at
  1331.     double its normal height. This option is useful when printing a font in 8-
  1332.     pin mode that otherwise would appear "stretched"; by doubling the font
  1333.     height, the height/width ratio is improved. When selected, this option will
  1334.     reduce the optimum number of lines per page by half.
  1335.     
  1336.     
  1337. _______________________________________________________________________________
  1338. ###############################################################################
  1339.     
  1340. CHAPTER 5: VIEWING/EDITING CHART
  1341.     
  1342.     Enter the name of a chart file that was saved previously, with
  1343.     EITHER the `Save Chart' or `Save as Text File' option on the
  1344.     <VIEWER MENU>. If the chart was saved as a text file, a temporary
  1345.     file in <CHART FORMAT> will first be created.
  1346.     
  1347.     Help sections available in CHAPTER 5:
  1348.     
  1349.     <VIEWER MENU>
  1350.     <VIEWING CHART>
  1351.     <EDITING CHART>
  1352.     <DISCARDING CHANGES>
  1353.     
  1354. _______________________________________________________________________________
  1355.     
  1356.     
  1357. VIEWER MENU
  1358.  
  1359.     The VIEWER MENU is accessed by pressing ESC while in the VIEW/EDIT mode:
  1360.     
  1361.   Save Chart        
  1362.   
  1363.     Select this option to save a chart. It will be saved in <CHART FORMAT>,
  1364.     which is a run-length encoded compressed file with a special header.
  1365.     Later, the chart may be loaded back into GENBOX, for further viewing,
  1366.     editing, and/or printing.
  1367.     
  1368.     
  1369.   Save as Text File 
  1370.   
  1371.     Select this option to save the chart in ASCII format. This format is
  1372.     convenient for transferring the chart to other systems that do not have
  1373.     GENBOX. A chart in this format may be directly printed with the DOS PRINT
  1374.     command. Warning: no attempt is made to save space; large charts can
  1375.     consume a lot of disk space.
  1376.     
  1377.     
  1378.   Print Options ...
  1379.   
  1380.     This option provides another point to access the <PRINTING> options window.
  1381.   
  1382.   
  1383.   Print Entire Chart      
  1384.   
  1385.     Select this option to print the entire chart. A progress bar will be
  1386.     displayed. 
  1387.     
  1388.     
  1389.   Print This Page  
  1390.   
  1391.     Select this option to print just the current page.
  1392.     
  1393.     
  1394.   Print Row
  1395.   
  1396.     Select this option to print all pages on the current row.
  1397.     
  1398.     
  1399.   Done            
  1400.   
  1401.     Select this option to exit the VIEW/EDIT mode and return to the main menu.
  1402.     If you wish to save the chart, you must choose either <Save Chart> or
  1403.     <Save as Text File> before exiting the VIEW/EDIT mode.
  1404.     
  1405. _______________________________________________________________________________
  1406.     
  1407.     
  1408. VIEWING CHART
  1409.   
  1410.     The chart is displayed onscreen, exactly as it will appear when printed.
  1411.     Page breaks are indicated.
  1412.     
  1413.     Press ESC to access the <VIEWER MENU>.
  1414.      
  1415.     To move around on the chart:
  1416.     
  1417.     ARROW KEYS     move one character position in arrow direction
  1418.     HOME KEY       move left one "scroll distance"
  1419.     END KEY        move right one "scroll distance"
  1420.     PAGE UP        move up one "scroll distance"
  1421.     PAGE DOWN      move down one "scroll distance"
  1422.     CTRL-PAGEDOWN  jump down one screenheight
  1423.     CTRL-PAGEUP    jump up one screenheight
  1424.     CTRL-LEFT      jump left one screenwidth
  1425.     CTRL-RIGHT     jump right one screenwidth
  1426.     CTRL-HOME      go to top-left of screen, then top-left of chart
  1427.     CTRL-END       go to bottom-right of screen, then bottom-right of chart
  1428.     
  1429.     NOTE: When the chart is first displayed, you are on page "A1". The screen
  1430.     may be blank if there is nothing in the top-left corner on the chart. If
  1431.     so, move right until you come to some boxes.
  1432. _______________________________________________________________________________
  1433.     
  1434. EDITING CHART
  1435.  
  1436.     To edit the chart, simply move the cursor to the desired position, and
  1437.     type the desired text. All editing is in OVERWRITE mode. You may use the
  1438.     BACKSPACE key to erase.
  1439.     
  1440.     To insert graphical characters: hold down the ALT key and type the numeric
  1441.     code of the desired character, using the numeric keypad. For example: to
  1442.     enter a vertical bar (│), hold down the ALT key and type `179' on the
  1443.     numeric keypad. NOTE: this capability may not be supported by your version
  1444.     of DOS.  Consult your DOS User's Guide for the table of codes available on
  1445.     your selected code page.
  1446.  
  1447. _______________________________________________________________________________
  1448.     
  1449. DISCARDING CHANGES
  1450.     
  1451.     If you have edited the chart, you will be asked if you wish to `Discard
  1452.     Changes' when you choose `Done' and the changes to the chart have not been
  1453.     saved yet. Answer by typing:
  1454.     
  1455.     `Y' or `y' for YES (discard changes and exit), or `N' or `n' for NO  (don't
  1456.     discard changes; stay in view/edit mode)
  1457.     
  1458.     
  1459.     
  1460. _______________________________________________________________________________
  1461. ###############################################################################
  1462.     
  1463. CHAPTER 6: TIPS AND TECHNIQUES
  1464.     
  1465.     Help sections available in CHAPTER 6:
  1466.     
  1467.     <SOURCES FOR GEDCOM FILES>  Where to find interesting GEDCOM files to use.
  1468.     <SHAPE CONTROL>             How you can control the overall chart "shape".
  1469.     <QUICK BOX CHARTS>          How to make a quick chart to check connections.
  1470.     <CHECKING BOX OPTIONS>      How to check box options before doing a chart.
  1471.     <EDITING GENBOX.OPT>        Additional techniques for controlling options.
  1472.     <BANNER-SIZE CHARTS>        How to make really large charts.
  1473.     
  1474. _______________________________________________________________________________
  1475.     
  1476.  
  1477. SOURCES FOR GEDCOM FILES
  1478.  
  1479.     An excellent source for GEDCOM files that you can use in GENBOX is the
  1480.     CompuServe Genealogy Forum (GO ROOTS). Library 7, Surnames & Tafels,
  1481.     contains a number of GEDCOM files uploaded by CompuServe users. Several of
  1482.     these GEDCOM files are included with the GENBOX registered version, for
  1483.     your amusement.
  1484. _______________________________________________________________________________
  1485.  
  1486. SHAPE CONTROL
  1487.  
  1488.     The overall "shape" of a chart, whether it appears to be balanced or
  1489.     lop-sided, tall and narrow or short and wide, depends largely on the data
  1490.     itself: how many marriages and children each individual has, and the order
  1491.     that the children and marriages are listed in the GEDCOM file. A balanced
  1492.     chart gives a better visual impact, and usually makes more efficient use of
  1493.     paper and display space. There are a number of techniques that can be used
  1494.     to influence the shape of the chart.
  1495.     
  1496.   Box Width vs. Box Height
  1497.   
  1498.     Tall and narrow charts can be made shorter and wider by REDUCING the box
  1499.     height, while at the same time INCREASING the maximum box width. Short and
  1500.     wide charts can be made (somewhat) taller and narrower by doing the
  1501.     reverse.
  1502.     
  1503.     
  1504.   Order of Starters
  1505.   
  1506.     By simply changing the order of the <STARTING NAMES> specified in the
  1507.     Custom Box Chart option, the overall chart shape can be affected. Often,
  1508.     this can result in reduced chart width.  The key is in which names to use
  1509.     as starters, and the order in which to enter them.
  1510.     
  1511.     In general, this is what is happening: children boxes, as a group, are
  1512.     centered beneath their parent box. Then, the parent box and its siblings
  1513.     are grouped as the children, and centered beneath THEIR parent box.
  1514.     
  1515.     After the descendants of each STARTING NAME are determined, their
  1516.     descendants, as a group, are placed next to each other. Any family box
  1517.     pair links between descendants of different starting names are drawn.
  1518.     
  1519.     When the major line of descendants is off of a starting name or parent box
  1520.     that is spaced far from the left edge of the chart, an empty block of space
  1521.     can appear to the left of the descendants. This space would be filled by
  1522.     the descendants of other boxes to the left of the parent box, if there were
  1523.     some.
  1524.     
  1525.     The solution is to "move" the box with the major bulk of the descendants
  1526.     closer to the left edge of the chart, so that its descendants are also
  1527.     close to the left edge, and the large, empty space is reduced. 
  1528.     
  1529.     To do this: first, go into Box Options and activate both the `Show primary
  1530.     person's RIN' option and the `Show spouse's RIN' option. Next, make your
  1531.     chart normally, to see what needs to be done. If you made an "everybody"
  1532.     chart, write down the RIN numbers of all the <STARTING NAMES> that are
  1533.     visible as boxes without any ancestors, in left-to-right order.  
  1534.     
  1535.     Next: note either the RIN of a starting box OR the RIN of the <SPOUSE> of a
  1536.     descendant box you wish to move to the left. We choose the SPOUSE, not the
  1537.     <PRIMARY PERSON>, because unless your box already is a starter, the primary
  1538.     person is a descendant of one of the selected starters, and all starters
  1539.     that are specified in the Custom Box Chart option must not be blood
  1540.     relatives.
  1541.     
  1542.     Add the RIN of the SPOUSE to the front of your STARTING NAMES list. 
  1543.     
  1544.     Now you are ready to make your "shape-improved" chart: Choose the Custom
  1545.     Box Chart option, and enter all of your starters. When the chart is made,
  1546.     you will notice that the selected box and its descendants are now on
  1547.     the left side of the chart, and everything else was adjusted accordingly.
  1548.     
  1549.     This process can be repeated to improve the shape in other areas of the
  1550.     chart.
  1551.     
  1552.     
  1553.   Overlapped Family Box Pair Links
  1554.   
  1555.     When the GEDCOM file contains many short ancestral lines for spouses to
  1556.     people in the main descendant lines of interest, the `Everyone' chart that
  1557.     results can be difficult to read. The short ancestral lines connected with
  1558.     dotted lines to the spouses tend to "stack up" at the sides of the chart,
  1559.     with their dotted line connectors all running together.
  1560.     
  1561.     The clue to reading the chart is to match up the names in each box: the
  1562.     correct family box pairing will contain the same two names. The connector
  1563.     on the bottom of each box in the pair will also point in the direction of
  1564.     the other box.
  1565.     
  1566.     Often, a different ordering of <STARTING NAMES> will produce a chart with
  1567.     fewer family box connector overlaps. Try using the `Custom Box Chart'
  1568.     option, and directly specify the order for just the starters you want to
  1569.     include.
  1570.     
  1571.     
  1572. QUICK BOX CHARTS
  1573.   
  1574.     A quick way to check box inclusions, connections, and overall shape is to
  1575.     set the Box Maximum Width, Box Minimum Width, and Box Height all to 1. Turn
  1576.     on the `Show primary person's RIN' and `Show spouse's RIN' options. Then
  1577.     make the chart. You will see a "miniature" chart of connected, tiny (empty)
  1578.     boxes. The RINs allow you to identify the boxes, even though no other
  1579.     contents are shown.
  1580.     
  1581.     Any time the minimum width is set equal to the maximum width and the height
  1582.     selected multiplied by the width is less than 10, a quick box chart will be
  1583.     produced, with empty box contents. The chart takes less time to produce
  1584.     because the GEDCOM file does not need to be accessed, and box content
  1585.     decisions do not need to be made.
  1586.     
  1587.     If the box is narrower than the number of digits in the RIN number, the RIN
  1588.     will overlap the box borders and the margin before the box. If you find
  1589.     this unappealing, you should select a min/max width value equal to the
  1590.     number of digits in the largest RIN. This will make your quick chart
  1591.     slightly wider, but it will look "cleaner".
  1592.     
  1593.     In any case: If your RINs are 4 digits (1000 or more people in your GEDCOM
  1594.     file), you must set the box min and max values to at least 2; for 10000 or
  1595.     more, set box min and max values to at least 3.
  1596.     
  1597.     
  1598.   Quick Charts with `Show family's MRIN' 
  1599.  
  1600.     If you turn on BOTH the `Show spouse's RIN' and `Show family's MRIN'
  1601.     options, limited space on your quick chart boxes may require the program to
  1602.     omit the family MRIN. Choose a fixed box width of 7 for 3-digit RINs to
  1603.     ensure that there is space for the MRIN (3 digits + space + 3 digits).
  1604.     
  1605.     
  1606. CHECKING BOX OPTIONS
  1607.  
  1608.     After changing box size or formatting options, you can get a preview of
  1609.     what the boxes will look like before producing a chart. This allows you to
  1610.     decide if your selected options are okay, or if you should make some
  1611.     adjustments. To check box options: simply choose the `Descendant' chart
  1612.     option, and enter a RIN number at random (or, enter the name of a person of
  1613.     your choice). The box selected will be shown with the selected options in
  1614.     effect: box height, box width constraints, wrapping, date format, selected
  1615.     data types, and so forth. To the question `Is this the right person?',
  1616.     press the ESC key.
  1617.     
  1618.     
  1619. EDITING GENBOX.OPT
  1620.  
  1621.     The options file, <GENBOX.OPT>, may be edited with any text editor. By
  1622.     directly editing the options file, it is possible to specify certain
  1623.     settings that are not possible within the normal OPTIONS MENU windows.
  1624.     
  1625.     The most important capability is in ordering the TAGS data lines. Suppose
  1626.     you load a data file that has the GEDCOM tag `TITL'. If GENBOX currently
  1627.     does not have an entry for this tag, it will create one, at the bottom of
  1628.     the tag list. Now, suppose you want title data to appear BEFORE NAME data,
  1629.     which has an order value of 1. You can set TITL data to have an order of 1,
  1630.     but unless you change NAME data to order 2 (and ripple all other order
  1631.     values down one level as well), the TITL data will appear AFTER the NAME
  1632.     data, because tags with the same ORDER value will be ordered in the box
  1633.     according to their order on the tag list. The solution is to edit the
  1634.     options file, GENBOX.OPT, and move the TITL tag line to the top of the
  1635.     list, ahead of the NAME tag line.
  1636.     
  1637.     
  1638. BANNER-SIZE CHARTS
  1639.  
  1640.     With proper printing option choices, it is possible to produce charts
  1641.     large enough to read from a distance, although a lot of paper will be
  1642.     consumed. First, select landscape mode. Use a large font, such as
  1643.     COUR24.FNT or GOTHIC24.FNT. Set DPI to 60, pin mode to 8, adn double the
  1644.     font height. You should experiment with printing a single page first, until
  1645.     you are happy with your combination of settings.
  1646.     
  1647.     
  1648. _______________________________________________________________________________
  1649. ###############################################################################
  1650.     
  1651. CHAPTER 7: FEDIT--FONT EDITOR UTILITY
  1652.     
  1653.     Provided with the registered version of GENBOX is FEDIT, a utility for 
  1654.     modifying or creating new fonts for use with GENBOX printing in landscape
  1655.     mode. GENBOX font files have their own special format; only fonts
  1656.     specifically create with the FEDIT utility may be used in GENBOX. To use
  1657.     FEDIT, at the DOS prompt type "fedit".
  1658.     
  1659.     The FEDIT main menu contains the following options:
  1660.     
  1661.     <LOAD FONT FILE>               Asks for GENBOX font file to load
  1662.     <CREATE NEW FONT>              Creates a new, empty font
  1663.     <MODIFY FONT PARAMETERS>       Accesses font parameters: view/edit
  1664.     <EDIT FONT CHARACTERS>         Displays character chart; select for editing
  1665.     <DOUBLE HEIGHT, ALL CHARS>     Stretches all chars to twice their height
  1666.     <DOUBLE WIDTH, ALL CHARS>      Stretches all chars to twice their width
  1667.     <GENERATE GRAPHICS CHARS>      Automatically defines graphics characters
  1668.     <SAVE FONT>                    Save the font to the specified filename
  1669.     Help                           Accesses toplevel online help
  1670.     Exit                           Exits the program
  1671.     
  1672. _______________________________________________________________________________
  1673.         
  1674.  
  1675. LOAD FONT FILE                 
  1676.  
  1677.     Type the name of a font file, such as COUR24, GOTHIC24, BASIC, or TOPAZ.
  1678.     If the font is in a subdirectory, include the directory path, as in
  1679.     "FONTS\TINY.FNT". If no file extension is given, ".FNT" will be assumed.
  1680.  
  1681.  
  1682. CREATE NEW FONT                 
  1683.  
  1684.     This option creates a new, empty font. It accesses the font parameters
  1685.     window. Note: You may find it easier to copy and modify and existing font,
  1686.     rather than starting with a completely empty font.
  1687.     
  1688.     
  1689. MODIFY FONT PARAMETERS          
  1690.  
  1691.     There are five font parameters that define the overall size and character
  1692.     range of each font:
  1693.     
  1694.   Font Height
  1695.   
  1696.     The height of all characters, in dots (1-24). It includes the spacing
  1697.     between the lines.
  1698.     
  1699.     
  1700.   Font Width
  1701.   
  1702.     The width of all characters, in dots (1-24). It includes the spacing
  1703.     between characters.
  1704.     
  1705.     
  1706.   Font Baseline
  1707.   
  1708.     The dot-line on which the font is "sitting". This value is included only
  1709.     for your convenience; when editing a character, the baseline is marked, to
  1710.     make it easier to align characters within the character cell. It does not
  1711.     affect the printed appearance of the font.
  1712.     
  1713.     
  1714.   Minimum character (ASCII)
  1715.   Maximum character (ASCII)
  1716.   
  1717.     These two values define the character range for the font. If you choose not
  1718.     to define, say, the special graphics characters that are assigned to the
  1719.     control codes (ASCII 1 - 31), you can set the minimum character to 32.
  1720.     Normally, fonts are defined for the entire ASCII range, 1 - 255. If there
  1721.     is a character to be printed on the chart that is outside the range of
  1722.     characters defined for the font being used, a space will be printed
  1723.     instead.
  1724.     
  1725.  
  1726. EDIT FONT CHARACTERS                
  1727.  
  1728.     When this option is chosen, a chart of all characters in the ASCII range
  1729.     is displayed. Use the arrow keys to position the cursor on the character
  1730.     of interest, and press ENTER. A large, editable image of the character
  1731.     will appear on the screen. On the left side of the screen is a listing of
  1732.     the editing commands that you can use:
  1733.     
  1734.     ARROW KEYS:      move cursor to a particular dot (bit)
  1735.     SPACE BAR:       toggles bit: white goes to black; black to white
  1736.     CTRL KEY+ARROWS: draws lines: if on black, draw white line; else black line
  1737.     ML:              move entire character left in cell
  1738.     MR:              move entire character right in cell
  1739.     MU:              move entire character up in cell
  1740.     MD:              move entire character down in cell
  1741.     FH:              flip character horizontally (backwards)
  1742.     FV:              flip character vertically (upside down)
  1743.     IV:              invert character: white bits go to black; black to white
  1744.     IR:              insert a copy of the current row
  1745.     DR:              delete the current row, moving lower rows up
  1746.     IC:              insert a copy of the current column
  1747.     DC:              delete the current column, moveing right columns left
  1748.     La:              load image of any (typed) letter on top of image
  1749.     CC:              clear
  1750.     
  1751.     There are also commands to save changes and go to other characters:
  1752.     
  1753.     N:               save changes, and go to the next ASCII character
  1754.     P:               save changes, and go to the previous ASCII character
  1755.     Ga:              save changes, and go to any (typed) character
  1756.     ENTER:           (press ENTER key) save changes, and return to char chart
  1757.     ESC:             (press ESC key) DISCARD CHANGES, and return to char chart
  1758.     
  1759.  
  1760. DOUBLE HEIGHT, ALL CHARS            
  1761.  
  1762.     This option causes all characters to be "stretched" to twice their current
  1763.     height, provided that this would not result in a font taller than 24 dots.
  1764.     The font height parameter is automatically updated.
  1765.  
  1766.  
  1767. DOUBLE WIDTH, ALL CHARS            
  1768.  
  1769.     This option causes all characters to be "stretched" to twice their current
  1770.     width, provided that this would not result in a font wider than 24 dots.
  1771.     The font width parameter is automatically updated.
  1772.  
  1773.  
  1774. GENERATE GRAPHICS CHARS           
  1775.  
  1776.     When selected, this option automatically generates the graphics characters
  1777.     in the ASCII range 176-223, and also ASCII code 249. These characters are
  1778.     generated according to an algorithm, and will work correctly regardless
  1779.     of the font parameters chosen. This option is provided because GENBOX
  1780.     uses the graphics characters to draw box borders and connecting lines;
  1781.     every font created for use with GENBOX needs to have these characters
  1782.     defined.
  1783.  
  1784.  
  1785. SAVE FONT                   
  1786.  
  1787.     This option saves the font to the specified filename.
  1788.     
  1789.     
  1790. _______________________________________________________________________________
  1791. ###############################################################################
  1792.     
  1793. APPENDIX A: READING THE CHARTS
  1794.     
  1795.     Help sections for APPENDIX A:
  1796.     
  1797.     <BOX CHART>              Sample portion of box chart, with parts labeled.
  1798.     <FAMILY BOX>             Description of a family box.
  1799.     <FAMILY BOX PAIRS>       Description of family box pairs.
  1800.     <DOTTED LINE SUMMARY>    A summary of the use of dotted lines.
  1801.         
  1802.     
  1803. _______________________________________________________________________________
  1804.         
  1805. BOX CHART - Sample portion of box chart, with parts labeled.
  1806.  
  1807.  
  1808.                (ancestors of A.J. DOE)            (ancestors of S.L. PETERSON)
  1809.                
  1810.             top root --> │          secondary marriage          │
  1811.                  ┌───────┴──────32┐ ┌───────────────32┐ ┌───────┴──────46┐   
  1812.                  │ANDREW J. DOE   ├∙┤ANDREW J. DOE    │ │SUSAN LYNN      │   
  1813.                  │b 8-Mar-1929    │ │b 8-Mar-1929     │ │        PETERSON│  
  1814.                  │Mount Samson, OH│ │ Mount Samson, OH│ │b 6-Jul-1932    │   
  1815.    parent -->    │m 19-Oct-1957   │ │m 5-Jun-1970     │ │  Smallville, NY│   
  1816.     box          │  Brookfalls, WA│ │Mountain View, KS│ │m 19-Oct-1957   │   
  1817.                  │SUSAN LYNN      │ │CANDICE PATRICE  │ │  Brookfalls, WA│   
  1818.                  │        PETERSON│ │            SMITH│ │ANDREW J. DOE   │   
  1819.                  │b 6-Jul-1932    │ │b 17-Aug-1936    │ │b 8-Mar-1929    │   
  1820.                  │  Smallville, NY│ │      Bigtown, WY│ │Mount Samson, OH│   
  1821.                  └16─────┬──────46┘ └17─────────────58┘ └16─────┬──────32┘   
  1822.                          ├∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙┘            
  1823.    parent/child link --> │                                   ^ 
  1824.                          │                                   | Family box link 
  1825.               ┌──────────┴───────197┐<-- RIN of primary person
  1826.    child -->  │WILLIAM JEFFERSON DOE│<-- primary person 
  1827.     box       │b 3-May-1961         │                    
  1828.               │        Sunnytown, FL│                    
  1829.               │m 11-Dec-1986        │                    
  1830.               │        Oceanside, NJ│                    
  1831.               │ANGELA CAROLYN       │ <-- spouse                   
  1832.               │            CARPENTER│
  1833.      label -->│b 22-Jan-1963        │ \
  1834.               │        Bear Lake, TN│  wrapped line; wrap is right-justified
  1835.               └35────────────────198┘ /                   
  1836.                ^     ^       ^    ^
  1837.                |     |       |    |
  1838.        family MRIN  date   place  RIN of spouse
  1839. _______________________________________________________________________________
  1840.      
  1841.      
  1842. FAMILY BOX
  1843.   
  1844.     A family box can contain one or two names. The first person listed is the
  1845.     <PRIMARY PERSON>. If the parents of this person are on the chart, they will
  1846.     be in a box above, with a connecting line. In the sample chart, this line
  1847.     is labeled `parent/child link'.
  1848.     
  1849. _______________________________________________________________________________
  1850.     
  1851. FAMILY BOX PAIRS
  1852.   
  1853.     If the parents of the <SPOUSE> are on the chart, there will be a SECOND
  1854.     family box containing the same two people, but with the spouse in the
  1855.     position of the PRIMARY PERSON. This box hangs below the SPOUSE'S parent
  1856.     box. Having the same two married people shown in two places allows the
  1857.     parents of both to be clearly indicated. The first box and the "reversed"
  1858.     box are together referred to as a Family Box Pair.
  1859.     
  1860.     
  1861.   Family Box Pair Connectors
  1862.   
  1863.     To show that two boxes contain the same people, a dotted line is drawn
  1864.     BELOW the boxes, connecting them. In the sample chart, this line is labeled
  1865.     `family box link'. Note also that the CHILDREN are only listed once: below
  1866.     just ONE family box in each family box pair.
  1867.     
  1868.     Whenever included on a chart, family box pairs will ALWAYS be shown on the
  1869.     same generational level, so that a horizontal dotted line can be drawn
  1870.     STRAIGHT ACROSS to connect them.  This means that if their parents are in
  1871.     different generational levels, an EXTENDED VERTICAL CONNECTOR will need to
  1872.     be drawn, to lower the child with the parents in the higher generational
  1873.     level to the same level as the child with the parents in the lower
  1874.     generational level.
  1875.     
  1876.     NOTE: on large `everybody' charts, it is possible for these dotted lines
  1877.     connecting family box pairs to be overlapped. To read such a chart
  1878.     correctly, each box with a bottom connector to the overlapped dotted lines
  1879.     must be checked to see if it is the pair to the box of interest.
  1880.     
  1881. _______________________________________________________________________________
  1882.     
  1883. SECONDARY MARRIAGES
  1884.   
  1885.     If the GEDCOM file lists a person as a husband or wife in more than one
  1886.     family, GENBOX will display an ADDITIONAL family box for each of these
  1887.     `secondary' marriages, if appropriate for the chart type selected. This
  1888.     allows each spouse's information to be distinguished, and also provides a
  1889.     separate connection point for the children of each of the secondary
  1890.     marriages.
  1891.     
  1892.     To show that these boxes are all marriages of the same <PRIMARY PERSON>, a
  1893.     dotted line is drawn BETWEEN the boxes, near the top. In the sample chart,
  1894.     there is a dotted line drawn between the first and second marriage boxes
  1895.     for Andrew J. Doe; the name of his first wife is Susan Lynn Peterson, and
  1896.     they had a son William Jefferson Doe; the name of his second wife is
  1897.     Candice Patrice Smith, and no children from that marriage are shown.
  1898.     
  1899.     If the SPOUSE has secondary marriages shown on the chart, they will be
  1900.     attached to the family box that has the spouse listed as the PRIMARY
  1901.     PERSON. In the sample chart, Susan Lynn Peterson is not shown as having any
  1902.     secondary marriages; if she did, they would be connected to the family box
  1903.     on the right.
  1904.     
  1905.     On DESCENDANT charts, secondary marriages of SPOUSES are usually not shown,
  1906.     because any children of these marriages would not be descendants of the
  1907.     <STARTING NAMES>. The same is true on CUSTOM charts, although if you wish
  1908.     to include the secondary marriages of a SPOUSE, include the spouse as one
  1909.     of the STARTING NAMES. On ANCESTOR charts, no secondary marriages for
  1910.     either the PRIMARY PERSON or the SPOUSE are shown.
  1911.     
  1912.     Note: so-called `secondary' marriages are not necessarily ordered in time:
  1913.     the left-to-right order of secondary marriages on the charts is determined
  1914.     by the order in which the marriages are listed in the GEDCOM file, not by
  1915.     the actual dates given (The same is true about the ordering of CHILDREN).
  1916.     
  1917. _______________________________________________________________________________
  1918.     
  1919. DOTTED LINE SUMMARY
  1920.   
  1921.     On GENBOX charts, there are two kinds of dotted lines: those that run
  1922.     horizontally BELOW the boxes, connecting <FAMILY BOX PAIRS>, and those that
  1923.     run BETWEEN boxes, connecting <SECONDARY MARRIAGES>. Secondary marriages do
  1924.     not always appear in the same generation, so the dotted lines connecting
  1925.     them may go DOWN a level (or more) as well as across.
  1926.     
  1927.     In general: every occurrence of an individual on a chart can be found by
  1928.     following the dotted lines that run between each occurrence, whether to
  1929.     secondary marriages, or to the pairing box in family box pairs. At most,
  1930.     there will be two boxes for each marriage that an individual has: if a
  1931.     person has three marriages, for example, each box could be shown with a
  1932.     connected family box pair, for a total of six boxes.
  1933.     
  1934.     
  1935. _______________________________________________________________________________
  1936. ###############################################################################
  1937.     
  1938. APPENDIX B: GLOSSARY
  1939.     
  1940.     Help sections for APPENDIX B:
  1941.     
  1942.     <CHART FORMAT>           A description of the GENBOX chart file format.
  1943.     <GEDCOM>                 The file format standard for genealogy transfer.
  1944.     <GENBOX.HLP>             The online help file.
  1945.     <GENBOX.OPT>             The options file.
  1946.     <GENBOX.TMP>             The temporary chart file.
  1947.     <MAXIMUM GENERATIONS>    The maximum number of generations supported.
  1948.     <MRIN>                   Marriage Record Identification Number.
  1949.     <PAGE NUMBERS>           Explanation of chart page numbering.
  1950.     <PRIMARY PERSON>         The first person named in a box.
  1951.     <PRIORITY PERSON>        Data has priority over other person in box.
  1952.     <RANK ADVANCEMENT>       Priority adjustments based on unavailable data.
  1953.     <RIN>                    Record Identification Number.
  1954.     <SPOUSE>                 The second person named in a box.
  1955.     <STARTING NAMES>         Names selected to produce a chart.
  1956.     
  1957. _______________________________________________________________________________
  1958.  
  1959. CHART FORMAT
  1960.    
  1961.     GENBOX produces and reads chart files in a special "chart format", which
  1962.     consists of run-length encoded data with a special header.
  1963.     
  1964.     The header contains:
  1965.     
  1966.        [255]PAGEWIDTH;PAGEHEIGHT;XPAGES;YPAGES\n
  1967.     
  1968.     The chart data is stored beginning with page A1, with the data for each
  1969.     page line delimited with the NULL (0) character. Pages are stored a row at
  1970.     a time. The run-length encoding is performed as follows:
  1971.  
  1972.         [char][255][repeat count]
  1973.     
  1974.     GENBOX can also store and read charts in ASCII text format. When reading an
  1975.     ASCII text chart, it first converts it to chart format (filename
  1976.     <GENBOX.TMP>). For this to work correctly, the following constraints are
  1977.     placed on the ASCII text file:
  1978.  
  1979.     *    All lines are padded with spaces to be the same length
  1980.     *    There is a `B' character in the first position on the page that
  1981.          begins the second row of pages.
  1982.      
  1983. _______________________________________________________________________________
  1984.  
  1985. GEDCOM - Genealogical Data Communication
  1986.     
  1987.     GEDCOM is a file format standard for exchanging computerized genealogical
  1988.     data. It was developed by the Family History Department of the Church of
  1989.     Jesus Christ of Latter-day Saints, and has become widely supported, by
  1990.     numerous genealogical programs.
  1991.     
  1992.     GENBOX requires the genealogical data to comply with GEDCOM Standard 4.0 or
  1993.     later. This standard is also known as PAF 2.1/2.2 format. Genealogy
  1994.     database programs that support this format include Personal Ancestral File,
  1995.     Brother's Keeper, and Roots III.
  1996.     
  1997.     If the normal data storage format used by your genealogy program is not
  1998.     GEDCOM, it will need to be converted, either with a utility that is part of
  1999.     your genealogy program, or with some other conversion utility. GEDCOM files
  2000.     are normally given an extension of .GED.
  2001.  
  2002.  
  2003.   Data Consistency Problems and Errors
  2004.   
  2005.     When GENBOX loads in your GEDCOM file, it checks it for consistency, and
  2006.     reports any problems and errors it discovers. The structure of GEDCOM files
  2007.     allows for double-checking links between children and parent families, and
  2008.     between people and marriages, because the linkage information is stored in
  2009.     two places: with the person's data, and with the family's data. When there
  2010.     is a link from a person to a family, but there isn't a link from the family
  2011.     back to the person, this is a DATA INCONSISTENCY.
  2012.     
  2013.     GENBOX can "repair" some inconsistencies, allowing you to still use the
  2014.     GEDCOM file without modification. Repairs are made in MEMORY: no actual
  2015.     changes are made to the GEDCOM file itself. Inconsistencies that GENBOX can
  2016.     fix are reported as `Data Problems'. Other, more serious data errors will
  2017.     be reported as `Data Errors', and prevent the file from being used at all.
  2018.     
  2019.     Make a note of the RINs and MRINs displayed in the messages displayed on
  2020.     the screen. Later, you may wish to use any text editor to correct the
  2021.     problems in your GEDCOM file, so that you don't see the same error messages
  2022.     each time you use the file.
  2023.  
  2024. _______________________________________________________________________________
  2025.  
  2026.     
  2027. GENBOX.HLP - The Help File
  2028.  
  2029.     This file is the source for all of the online help functions. It is a
  2030.     normal ASCII text file, which may be printed out for a hard copy of the
  2031.     user documentation. This text you are now reading is part of that file.
  2032.     
  2033.     The GENBOX program finds help sections by the section titles, both major
  2034.     and minor. The major section titles begin in column 0 and appear in
  2035.     uppercase. The minor section titles begin in column 2 and appear in mixed
  2036.     case. WARNING: do not attempt to edit this file. It may prevent GENBOX
  2037.     from finding the help section data when a help function is requested.
  2038.     
  2039.     
  2040. GENBOX.OPT - Default Options File
  2041.  
  2042.     This ASCII file contains a record of all of the user-settable options. It
  2043.     is read in when the program is started, and any changes to the user-
  2044.     settable options are written back out to the file when the program is
  2045.     exited. If the file can not be found when GENBOX is started, and an
  2046.     alternative options file is not specified on the command line, a warning
  2047.     will be issued, and a new options file with the system default values will
  2048.     be created.
  2049.     
  2050.     The file is divided into two sections: non-tag options, and tag options.
  2051.     Each line in the first part of the file has three parts: MENU, OPTION
  2052.     CODE, and VALUE. The option codes are two letters. For identification of
  2053.     the codes used, see the help section for the option in question: all
  2054.     options codes are shown to the right of the option name, as in:
  2055.    
  2056.         Include `Key' Page? (Y)es (N)o:                                      KP
  2057.           
  2058.     Here, `KP' is the options code for this option. In the options file, the
  2059.     value for this option might appear as:
  2060.     
  2061.         GENERAL   KP N
  2062.     
  2063.     For the tag section, each line represents the configuration for one GEDCOM
  2064.     LEVEL 1 tag. It has 6 parts, separated by semi-colons: TAG, NAME, LABEL,
  2065.     ORDER, RANK, LEVEL. For example, the BIRTH tag entry might appear as:
  2066.     
  2067.         BIRT;Birth;b;2;2;5
  2068.         
  2069.     For information on these six tag data items, see <TAGS>.
  2070.     
  2071.     
  2072. GENBOX.TMP - Temporary Chart File
  2073.  
  2074.     This is the temporary chart file created by GENBOX. It is overwritten each
  2075.     time a chart is produced. The GENBOX Viewer/Editor reads this file and
  2076.     updates it when you edit the chart. The `Save Chart' viewer menu option
  2077.     simply makes a copy of this file.
  2078.     
  2079.     The GENBOX.TMP file is not deleted when GENBOX exits. It will contain a
  2080.     copy of the last chart produced. You can restart GENBOX, select the
  2081.     `View/Edit Saved Chart' option, and specify `GENBOX.TMP' as the name of
  2082.     the chart file to load, to view this chart again.
  2083.     
  2084.  
  2085. MAXIMUM GENERATIONS
  2086.     
  2087.     The maximum number of generations supported by GENBOX is 255, which should
  2088.     be more than adequate for your needs: at an average of 20 years per
  2089.     generation, 255 generations spans over 5000 years. 
  2090.     
  2091.     
  2092.   Enter maximum number of Generations:
  2093.  
  2094.     For the Custom Box Chart option, you directly specify the number of
  2095.     MAXIMUM GENERATIONS. When asked, enter a number between 1 and 255. This
  2096.     number will be used for the MAXIMUM number of generations to show; if
  2097.     there are fewer generations of data actually available, the number of
  2098.     generations will be equal to the smaller number.
  2099.     
  2100.     
  2101. MRIN - Marriage Record Identification Number
  2102.  
  2103.     Each family in the GEDCOM file is assigned a unique number, called the
  2104.     MRIN, which is used in references between people and families.
  2105.     
  2106.     The MRIN for each family may optionally be displayed in the bottom-left
  2107.     corner of each family box on the chart, for easy reference. Boxes with
  2108.     single people will not show a family MRIN.
  2109.     (See: <BOXES>)
  2110.     
  2111.     NOTE: if the MRINs in the GEDCOM file are not sequential, they may be
  2112.     automatically renumbered by GENBOX, into a sequential set starting with
  2113.     zero.
  2114.     
  2115.     
  2116. PAGE NUMBERS
  2117.     
  2118.     Page numbers have two parts, which indicate the page position vertically
  2119.     and horizontally. `A1' is the first page number of every chart. The "A"
  2120.     indicates it is on the first horizontal row of pages. The "1" indicates it
  2121.     is the first page on that row. A small chart may have pages numbered A1
  2122.     through A4, with all the pages in a single row. A larger chart may have
  2123.     pages numbered from A1 through D6, indicating a chart that is 6 pages wide
  2124.     and four pages high.
  2125.     
  2126.     For charts higher than 26 pages, the first part of the page number becomes
  2127.     two letters instead of one, forming a base-26 page row number. The first
  2128.     page in the 27th page row would be labeled `AA1'. For the second page in
  2129.     the 30th row,  `AD2'. For the 25th page in the 100th page row, `CV25'.
  2130.     
  2131.     Note that page numbers have no connection to the number of generations;
  2132.     there are usually several generations displayed on each page row.
  2133.    
  2134.    
  2135. PRIMARY PERSON
  2136. SPOUSE
  2137.     Each box on the charts contains either one or two people. If there are
  2138.     names of two people in a box, this represents a marriage. The name listed
  2139.     FIRST in the box is the name of the PRIMARY PERSON. The name listed SECOND
  2140.     in the box is the name of the SPOUSE. The top link of the box will be to
  2141.     the parents of the PRIMARY PERSON.
  2142.     
  2143.     
  2144.     
  2145. PRIORITY PERSON
  2146.  
  2147.     GENBOX supports an optional data-priority biasing scheme for the cases
  2148.     where a person appears in more than one box on the chart. This scheme makes
  2149.     it possible to include more information on the chart than if a purely
  2150.     balanced scheme was used.
  2151.  
  2152.     In general: if a person has already appeared in another box on the chart,
  2153.     priority is given to the OTHER person in the current box. The non-priority
  2154.     person's name is normally included, and all FAMILY data is included, but
  2155.     all other data available on the non-priority person is restricted:
  2156.     depending on the setting of the `Priority Person Biasing' option (see
  2157.     <BOXES>), it is either EXCLUDED, or REDUCED IN RANK such that
  2158.     it is shown only when there is room left after showing all of the data from
  2159.     the PRIORITY PERSON. 
  2160.     
  2161.     There are two cases when the same person appears in more than one box: when
  2162.     the ancestors of both husband and wife appear on the chart (resulting in
  2163.     <FAMILY BOX PAIRS>), and when a person has <SECONDARY MARRIAGES>.
  2164.     
  2165.     For the first case: priority is given to the data of the <PRIMARY PERSON>.
  2166.     Since both the husband and wife appear as the primary person beneath their
  2167.     respective parent boxes, more data on both the husband and wife can be
  2168.     shown.
  2169.     
  2170.     For the second case: priority is given to the data of the <SPOUSE>. Since
  2171.     the primary person already appeared in the first marriage box, priority
  2172.     can be given to the spouses of the secondary marriages.
  2173.     
  2174.     Note that this data-priority biasing scheme is in addition to the normal
  2175.     priority system, determined by the settings on the <TAGS> options window.
  2176.     
  2177.  
  2178. RANK ADVANCEMENT
  2179.  
  2180.     An occasional situation arising in genealogies is that basic information,
  2181.     such as birth or death, is not available for a person, but a related data
  2182.     item, such as baptism or burial, IS available. Unfortunately, there may not
  2183.     be enough space in the box to include BOTH birth and baptism information
  2184.     for other people who have more complete information. It would be nice if we
  2185.     could say: "When BIRTH data is unavailable for a person and BAPTISM data IS
  2186.     available, show BAPTISM data; otherwise, show ONLY BIRTH data." GENBOX
  2187.     supports this conditional inclusion of data through a feature called RANK
  2188.     ADVANCEMENT.
  2189.     
  2190.     The approach taken by GENBOX is as follows: when the basic data is
  2191.     unavailable, the RANK value on any attached RELATED data item is ADVANCED
  2192.     to be the same as the unavailable basic data. Suppose BIRTH data has a rank
  2193.     of 2, and BAPTISM data has a rank of 10. That means that in the normal
  2194.     course of things, all available data types that have a rank between 1 and 9
  2195.     will be included in the box before BAPTISM data, meaning that the BAPTISM
  2196.     data may occasionally be left out, from lack of room in the box.  But when
  2197.     BAPTISM data is attached to BIRTH data, and BIRTH data is unavailable, the
  2198.     rank on BAPTISM data is ADVANCED from rank 10 to rank 2, which is the rank
  2199.     of the unavailable BIRTH data. In this case, the BAPTISM data will likely
  2200.     be included, bumping some other data item out of the box.
  2201.     
  2202.     All that needs to be done to activate the RANK ADVANCEMENT feature is to
  2203.     indicate which data types are RELATED to other (preferred) data types.
  2204.     This is accomplished on the <TAGS> options window, with a special ORDER
  2205.     value.
  2206.     
  2207.     To indicate a relation between a data type and another (preferred) data
  2208.     type: make its ORDER value equal to the NEGATIVE of the preferred data
  2209.     type.  Suppose BIRTH has an order value of 2, so that it comes right after
  2210.     the NAME, which has an order value of 1. To attach BAPTISM to BIRTH, you
  2211.     would set its ORDER value to -2. The negative sign indicates that this data
  2212.     type is related to another data type, and the 2 indicates that it is
  2213.     related to the data type that has a (positive) ORDER value of 2, which is
  2214.     the BIRTH field. When BIRTH data is unavailable and BAPTISM data IS
  2215.     available, the BAPTISM data will appear after the NAME, where the BIRTH
  2216.     data normally would go.
  2217.     
  2218.     In this example, when there IS birth data available, the rank on BAPTISM
  2219.     data would remain at 10; if space permits, it would still be included, and
  2220.     an ORDER value of 2 would be used for placement within the box, putting it
  2221.     near the BIRTH data (actual ordering among data types with the same ORDER
  2222.     value depends on the order that the tags are listed in the TAG OPTIONS
  2223.     WINDOW).
  2224.     
  2225.     For proper use of this feature, there should be only ONE basic data type
  2226.     that has the ORDER value that the related fields point to. There CAN be
  2227.     several data types related to the same basic data type; they will all be
  2228.     considered candidates for advancement. Among the candidates, their normal
  2229.     ranking will determine the order of their consideration; if equally ranked,
  2230.     their order on the list in the TAGS options window will be used. In any
  2231.     case, only the first related data item for which there is data available
  2232.     will be advanced in rank; once an advancement has been made, the other
  2233.     candidates drop back to their normal rank values.
  2234.     
  2235.     
  2236. RIN - Record Identification Number
  2237.  
  2238.     Each person in the GEDCOM file is assigned a unique number, called the RIN,
  2239.     which is used in references between children, parents, and spouses. The RIN
  2240.     may be used to select people to chart, instead of typing in names. (See:
  2241.     <PERSON SELECTION>)
  2242.     
  2243.     The RIN of the <PRIMARY PERSON> and/or the <SPOUSE> may optionally be
  2244.     displayed on the corners of the boxes, for easy reference.
  2245.     (See: <BOXES>)
  2246.     
  2247.     NOTE: if the RINs in the GEDCOM file are not sequential, they may be
  2248.     automatically renumbered by GENBOX, into a sequential set starting with
  2249.     zero.
  2250.     
  2251.     
  2252. STARTING NAMES
  2253.     
  2254.     All charts are produced top-down, beginning with the STARTING NAMES. For
  2255.     the Descendants chart, there is one starting name: the person entered. For
  2256.     the Ancestors chart, the program starts with the person entered and
  2257.     determines all of the starting names automatically. For the Everyone chart,
  2258.     the program determines the minimum set of starting names necessary to
  2259.     display every person, family, and connection in the GEDCOM file.
  2260.     
  2261.     
  2262.   Enter number of Starting Names:
  2263.  
  2264.     For the Custom Box Chart you directly specify all of the STARTING NAMES,
  2265.     which provides for maximum chart flexibility. When asked, enter first the
  2266.     NUMBER of starting names that you would like to enter (a number between 1
  2267.     and 255). Next, you will be asked to enter the name for each starting
  2268.     person.
  2269. ______________________________________________________________________________    
  2270.     
  2271. _______________________________________________________________________________
  2272. ###############################################################################
  2273.     
  2274. APPENDIX C: RELEASE NOTES
  2275.  
  2276.       
  2277.   Version 2.0 - March 1, 1994
  2278.   
  2279.     1) Landscape printing on IBM and EPSON-compatible printers is now
  2280.        supported. Charts can be printed in continuous horizontal "strips", for
  2281.        easier assembly. Supports both 8-pin and 24-pin printing.
  2282.        
  2283.     2) Font support has been added, for landscape printing. Several fonts of
  2284.        various styles and sizes are supplied. FEDIT, a font editor utility,
  2285.        is also provided, so that fonts can be modified and new fonts may be
  2286.        created.
  2287.        
  2288.     3) Direct setting of character pitch, line spacing, and paper size is now
  2289.        supported.
  2290.     
  2291.     4) Page widths of up to 255 characters now work correctly.
  2292.     
  2293.     5) German month abbreviations are now recognized.
  2294.     
  2295.     6) Highlighted box borders are now handled independently of "normal" box
  2296.        borders.
  2297.        
  2298.        
  2299.   Version 1.3 - April 16, 1993
  2300.     
  2301.     1) Memory handling has been greatly improved. Depending on the amount of 
  2302.        conventional memory available (the first 640k of RAM), the upper
  2303.        limit on the size of GEDCOM files that can be processed successfully is
  2304.        6000 - 9000 people or more.
  2305.        
  2306.     2) GEDCOM files with large RINs (up to 2147483647) can now be loaded.
  2307.        
  2308.     3) Two-part RINs (such as @I1212:45678@ or @F3918-2@) are now supported.
  2309.        Each part may have up to 5 digits, with maximums of 19999:99999. The
  2310.        part separator can be any non-digit, non-space character(s).
  2311.     
  2312.     4) All RINs in files with large RINs or two-part RINs are renumbered,
  2313.        using consecutive numbers starting at 0.
  2314.        
  2315.     5) Alternate line-drawing character codes may now be directly specified,
  2316.        for users with printers that do not support the PC line-drawing
  2317.        character codes. In previous versions, the alternate character codes
  2318.        were fixed.
  2319.        
  2320.     6) If the alternate characters are selected, you may now specify whether
  2321.        they should be applied when the chart is MADE, or when the chart is
  2322.        PRINTED. If applied when the chart is MADE, then the Viewer will show
  2323.        the alternate characters. Otherwise, the alternate characters will
  2324.        appear only on the printed chart: the viewer will show the normal
  2325.        line-drawing characters. There are advantages/disadvantages to both
  2326.        choices. One advantage of applying the alternate codes when the chart
  2327.        is MADE is that if the GEDCOM DATA contains some of the same codes
  2328.        (used for foreign characters, for example), they will not be changed.
  2329.        
  2330.     7) The "blank line" and missing "0 TRLR" problems of GEDCOM files created
  2331.        with older TMG beta versions are now accomodated. (The previous version
  2332.        fixed the RIN-header problem of TMG-produced GEDCOM files only.)
  2333.        
  2334.     8) Accidently pressing the left/right arrow keys in the menus now has no
  2335.        effect.
  2336.        
  2337.        
  2338.   Version 1.2 - April 9, 1993    
  2339.     
  2340.     1) Some of the advanced features previously available only in the
  2341.        registered version are now included: all settings on the BOX OPTIONS
  2342.        window have been enabled.
  2343.     
  2344.     2) Problems using GEDCOM files produced by TMG (The Master Genealogist)
  2345.        have been corrected.
  2346.     
  2347.     3) 8-bit characters are now handled properly, for GEDCOM files containing
  2348.        international characters.
  2349.        
  2350.     4) The line wrap routine has been improved: wrapping can now occur
  2351.        after any punctuation, not just on spaces.
  2352.     
  2353.     5) Assorted minor corrections in error handling were made.
  2354.     
  2355.     
  2356.     VERSION 1.1 - March 30, 1993
  2357.     
  2358.     1) Fixed problem with printing on some printers: A message "Printer is
  2359.        BUSY/OFFLINE" would sometimes appear, even when the printer was ready.
  2360.        
  2361.        
  2362.   Version 1.0 - March 20, 1993
  2363.     
  2364.     Initial release of GENBOX.
  2365.     
  2366. _______________________________________________________________________________
  2367.